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Section  I 


GENERAL 

1.  PURPOSE:  The  purpose  of  this  Wartime  Requirements  for  Ammunition, 
Materiel,  and  Personnel  (\VARRAMD)  Materiel  Postprocessor  User's  Manual 
is  to  document  the  description  and  structure  of  the  software  programs  that 
compose  the  materiel  postprocessor  (MPP).  Documentation  includes  all  the 
component  programs  of  the  materiel  postprocessor  with  an  individual  des¬ 
cription  of  their  structure,  the  data  base,  the  UNIVAC  runstreams,  input 
data,  and  sample  output  data  sufficient  to  provide  a  potential  user  with 
simple  instructions  and  clear  examples  of  how  to  prepare  the  input  data  files 
and  execute  the  programs  on  the  UNIVAC  hardware. 

2.  APPLICATIONS:  The  Materiel  Postprocessor  is  designed  in  total,  to  support 
analysis  of  materiel  (major  items  of  equipment)  as  a  part  of  the  WARRAMP 
methodolgy.  Other  applications  may  be  developed  based  upon  a  user's  study 
of  the  component  programs  and  determining  applicability. 

3.  SECURITY  and  PRIVACY:  The  individual  software  components  (pro- 
grams)  are  cataloged  as  indicated  under  the  detailed  descriptions  for  each 
program.  In  each  case,  they  are  cataloged  in  the  public  mode  for  user 
access.  User's  are  asked  not  to  modify  or  edit  (write)  in  the  program  files. 
In  event  alteration  is  required  for  a  specific  purpose,  a  potential  user  should 
copy  the  program  to  a  file  under  his/her  user  identification,  and  then  edit 
the  file  as  desired.  In  event  of  error  detection  during  use,  the  user  is 
requested  to  note  the  error  by  program  line  and  forward  the  proposed  cor¬ 
rection  to  the  program  custodian,  so  that  the  record  program  may  be 
updated.  Test  (sample)  data,  either  input  or  output  and  the  programs 
contained  herein  are  unclassified.  Users  must  apply  the  appropriate  security 
classifications  to  their  data  files  and  are  responsible  for  the  safeguard  of 
printed  matter  accordingly. 

4.  CONFIGURATION:  Figure  1.4.1  depicts  the  overall  WARRAMP  system. 
The  portion  of  the  system  which  this  document  concentrates  on  is  contained 
in  the  heavy-lined  box. 

4.1  METHODOLOGY: 

a.  The  central  building  block  of  the  Wartime  Replacement  Factors 
(WARF)  methodology  is  the  Systems  for  Estimating  Materiel 
Wartime  Attrition  and  Replacement  Requirements  (SYMWAR) 
system.  SYMWAR  developed,  from  historical  data,  loss  rates 
for  each  of  10  causes  of  loss,  4  combat  postures,  in  5  zones  of 
the  theater  for  36  classes  of  equipment.  A  list  of  the  36 
SYMWAR  historical  classes  is  at  Figure  1.4.2.  A  pictorial  view 
of  the  loss  rates  for  a  particular  item  of  equipment  as 
developed  in  SYMWAR  is  shown  in  Figure  1.4.3.  This  3- 
dimensional  matrix,  now  called  the  WARF  matrix,  contains  200 
cells.  The  cell  in  the  upper  left  front  would  contain  the  rate  of 
loss  inflicted  by  direct  fire  on  that  fraction  of  the  equipment 
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located  at  the  Forward  Edge  of  the  Battle  Area  (FEBA)  and  in 
an  attack  posture.  By  applying  data  on  the  distribution  of 
equipment  item  over  the  five  zones  and  combat  postures,  an 
overall  equipment  loss  rate  may  be  computed. 

The  portion  of  the  WARF  matrix  enclosed  by  dotted  lines  in 
Figure  1.4.3  represents  the  area  in  which,  in  the  WARF  system, 
simulations  results  are  substituted  for  the  historical  data  of 
SYMWAR.  These  48  cells  represent  combat  losses  within  30 
kilometers  of  the  FEBA.  That  is  the  area  in  which  current 
combat  simulations  have  the  most  credibility. 

In  the  WARF  system,  each  equipment  item  is  placed  into  one  of 
three  categories. 

(1)  Combat  equipment  which  can  be  expected  to  suffer 
significant  direct  fire  losses  (tanks,  APC,  antitank 
missile  launchers,  etc.)  is  simulated  in  detail  in  close 
combat  situations.  The  data  developed  in  these  sample 
situations  are  used  as  a  basis  for  the  assessment  of  losses 
in  a  theater  combat  simulation  over  an  extended  period 
of  time  (for  example,  180  days).  These  theater  losses  are 
applied  in  the  upper  left  corner  (within  the  dotted  lines) 
of  the  WARF  matrix.  The  detailed  combat  simulations 
currently  being  used  are  those  used  in  the  series  of 
studies,  Ammunition  Combat  rates,  which  develop  the 
Army's  conventional  ammunition  requirements.  The 
theater  simulation  is  the  Concepts  Evaluation  Model 
(CEM),  used  in  the  series  of  Total  Army  Analysis  (T  A  A) 
on  which  the  Army's  force  structure  is  based.  In 
principle,  however,  any  set  of  models  could  be  used. 

(2)  Other  equipment  types  which  are  not  normally  involved 
in  direct  fire  engagements  (5-ton  trucks,  rough  terrain 
forklifts,  radars,  etc.)  but  which  are  located  close  enough 
to  the  FEBA  to  be  subject  to  significant  losses  from 
artillery  and  air  form  the  second  category.  They  are 
subjected  to  detailed  analysis  through  a  target 
acquisition/fire  planning/indirect  fire  series  of 
simulations.  The  results  of  this  process  form  the  basis 
for  losses  due  to  area  fire  and  air  within  the  first  three 
zones  of  the  theater.  Direct  fire  losses  for  this  category 
are  estimated  from  the  SYMWAR  historical  data. 

(3)  The  third  category  contains  items  which  are  not  normally 
located  in  Zones  1,  2,  or  3  or  which  for  methodology 
limitations  reasons  cannot  be  simulated.  Losses  for 
these  items  are  those  in  the  original  SYMWAR  system. 

Intertheater  shipping  losses,  losses  in  depots,  and  along  the  in¬ 
theater  Lines  of  Communications  (LOC)  are  computed  as 
percentage  add-ons  to  the  basic  theater  loss  rates. 


4.2  INPUTS/OUTPUTS  -  Figure  1.4.4  identifies  all  utilities  and  data 
currently  in  the  Materiel  Post  Processor  (MPP).  Further  it  details 
which  files  are  required  as  input  to  specific  utilities  by  using  "I"  in  the 
common  box  for  the  two  items.  Also  files  produced  by  specific  util¬ 
ities  are  identified  by  an  "O"  in  the  box  at  the  intersection  of  the  file 
and  utility.  For  example  if  the  user  is  required  to  execute  the 
ITMID/TEMP  utility  from  Figure  1.4.3,  it  can  be  seen  that  the 
DENSITY/PROFILES,  QUANTITY/PROFILES  and  LINCODE/L1ST  files 
will  be  required  as  input  files  and  the  ITMID/TEMP  file  will  be 
produced  as  the  output  file. 
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Figure  1.4.1 


SYMWAR 

Historical  Equipment  Classes 


1.  Strike  airplane 

2.  Surveillance  airplane 

3.  Utility  airplane 

4.  Airplane  subsystem 

5.  Strike  helicopter 

6.  Surveillance  helicopter 

7.  Utility  helicopter 

8.  Helicopter  subsystem 

9.  Missile 

10.  Howitzer,  self-propelled 

11.  Howitzer,  towed 

12.  Gun,  (20mm  and  above),  self-propelled 

1 3.  Gun,  (20mm  and  above),  towed 

14.  Tank 

1  5.  Carrier,  mortar,  self-propelled 

16.  Mortar 

17.  Machinegun 

18.  Recoilless  rifle 

19.  Individual  weapon 

20.  Armored  personnel  carrier 

21.  Truck  (less  than  2  1/2  ton) 

22.  Truck  (2  1/2  ton  and  above) 

23.  Trailer /semi-trailer 

24.  Engineering 

25.  Other  type  vehicles 

26.  Communications 

27.  Electronic 

28.  Searchlight 

29.  Generator 

30.  F  uel  tank 

31.  Landing  craft 

32.  Other,  individual  miscellaneous  equipment 

33.  Other,  miscellaneous  equipment 

34.  Pumps  and  compressors 

35.  Marine  equipment  less  landing  craft 

36.  Mine  detectors,  night  vision  sights 


Figure  1.4.2 


Figure  1.4.3  WARF  Matrix 
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SECTION  II 
SYSTEM  SUMMARY 


GENERAL  DESCRIPTION:  Before  discussing  the  current  methodology,  it  is 
of  utmost  importance  to  understand  the  limiting  position  of  WARF.  The 
methodology  as  described  in  the  previous  section  assumes  that  equipment 
losses  can  be  described  via  the  WARF/SYMWAR  matrix.  This  matrix 
postulates  that  equipment  is  destroyed  by  10  causes,  is  located  in  5  zones 
(describes  the  entire  theater),  and  that  the  force  owning  the  equipment  is 
found  in  4  postures  (attack,  defense  intense,  delay,  and  defense  light).  The 
SYMWAR  data  base  is  so  organized  and  demands,  when  merged  with 
simulations,  complete  conformity  to  the  matrix.  If  the  assumptions  change, 
then  SYMWAR  cannot  be  used  as  a  data  base. 

The  following  definitions  apply  to  describe  the  current  methodology: 

a.  DAILY  WARF(i)  = 


_ Total  Kills(i)  _ 

Average  Theater  TOE*  Authorization(i)  x  0  Days  In  Period(i) 

(TOE  =  Table  of  Equipment) 

b.  Total  Kills  =  Only  permanent/  catastrophic/nonrepairable  losses. 

c.  i  =  Each  of  the  seven  specific  time  periods  (1ST15,  2ND15,  2ND30, 
3RD30,  4TH30,  5TH30,  6TH30).  For  report  purposes,  1ST30,  1ST90,  and 
2ND90  can  be  added. 

d.  WARF  RATE  =  Average  daily  loss  rate  expressed  as  a  percent  of  the 
average  authorized  TOE  strength  in  the  combat  theater  per  time  period. 

The  significant  changes  unique  to  the  WARF  P-86  effort  are: 

a.  A  rewrite  of  the  WARF  generator  model  currently  known  as  the  Equip¬ 
ment  Loss  Consolidator  (ELCON).  In  addition  to  a  complete  recoding, 
some  new  features  were  added  and  are  explained  in  Chapter  1  of  the 
ELCON  documentation. 

b.  The  original  WARF  studies  used  an  input  called  density  profiles  to 
acknowledge  the  location  of  equipment  by  WARF  zone.  WARF  P-85 
obtained  this  input  from  the  Logistics  Evaluation  Agency  (LEA)  by  zone 
for  each  of  the  seven  basic  time  periods.  In  order  that  equipment 
match  CAA's  arrayed  locations,  scheme  by  TOE  was  furnished  to  LEA 
for  WARF  P-86  to  insure  that  the  division  area  (zones  1,  2,  and  3)  was 
properly  described.  This  entailed  an  extraction  from  the  arrays  sup¬ 
porting  the  P-86  study  of  units  by  TOE/SRC  (Standard  Requirements 
Code)  and  a  corresponding  WARF  zone  location.  LEA  was  able  to 
determine  units  in  zones  4  and  5  by  exception. 
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c.  The  stylized  day  model,  WARF-RAM  (Red  Artillery  Model),  is  used  to 
generate  artillery  losses  for  items  not  played  in  the  theater  model 
(CEM)  nor  classified  as  pure  historic  items,  i.e.,  all  losses  derived  from 
SYMWAR.  Prior  to  WARF  P-S6  equipment  was  placed  into  32  notional 
target  complexes  which  were  fired  upon  by  WARF-RAM.  Since  units 
(battalion,  company,  platoon,  etc.)  are  acquired  as  targets,  not  equip¬ 
ment,  the  notional  complexes  were  dropped  in  favor  of  the  actual  units 
from  the  arrays.  This  allows  WARF-RAM  to  reduce  units  acquired  by 
the  Target  Acquisition  Model  (TAM)  with  no  adjustment. 

d.  WARF-RAM  produces  22  loss  rates  (one  for  each  equipment  vulner¬ 
ability  category)for  each  combat  posture  (attack,  defense  intense, 
delay,  and  defense  light).  Because  of  its  stylized  day  nature,  these  loss 
rates  are  unchanged  for  the  entire  period  of  conflict.  Thus,  Red's 
ability  to  destroy  Blue  equipment  never  varies  and  does  not  recognize 
any  degradation  of  Red  artillery  nor  decreasing  availability  of  Blue 
targets.  To  better  reflect  Red's  capability,  data  was  extracted  from 
CEM  output  (Log  Report)  so  that  time-oriented  factors  could  be 
developed  which  would  be  applied  to  degradate  each  loss  rate. 

1.1  DATA  REQUIREMENTS:  An  overall  description  of  the  WARF  system  is  in 
order  so  that  proper  linkages  are  explained.  To  begin  to  examine  the  study 
flow,  a  listing  of  the  data  requirements  will  assist  in  following  the 
transition. 

a.  Listing  of  the  Major  Items  of  Equipment  (MIE)  Authorized  War  Reserve 
Stocking 

(1)  Provided  by  ODCSOPS  (DAMO-RQR) 

(2)  List  includes  line  item  (LIN)  code— a  six  position  alpha-numeric 
and  the  noun  nomenclature  for  each  item. 

(3)  Each  MIE  is  assigned  a  weapon  number  or  vulnerability  category 
and  historical  class.  This  normally  includes  a  CEM  weapon  or 
WARFRAM  Vulnerability  Category  (1-22)  and  historial 
(SYMWAR)  class  (1-36)  as  assigned  by  CAA. 

b.  Density  and  Quanity  Profiles  for  each  MIE 

(1)  Provided  by  LEA  on  tape. 

(2)  Format  is  theater  wide  percent  by  zone  and  authorized  TOE 
quantity  by  time  period. 

(3)  LEA  is  provided  the  MIE  list  by  ODCSOPS  and  the  unit  array 
scheme  for  zones  1-3  by  CAA. 

c.  A  Logistics  Throttle  which  gives  the  Capability  of  the  Heavy  Materiel 
Supply  (HMS)  Companies  to  Deprocess  Heavy  Equipment  (tanks,  ARC, 
artillery). 
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(1)  Provided  by  LEA. 


Is  used  to  develop  the  LOG  file  for  CEM  for  both  the  AMMO  and 
WARF  CEM  cases. 

Unconstrained  equipment  resupply  is  an  inherent  assumption  of 
WARF;  however,  this  unlimited  quantity  is  throttled  by  the  capa¬ 
bility  of  the  HMS  companies. 

A  similar  approach  is  taken  for  the  AMMO  CEM  using  pro¬ 
grammed  quantities  of  resupply  equipment,  but  limited  to  the 
throttle. 


Inter-  and  Intra-Theater  (LOC)  Shit 


Losses 


(1)  Provided  by  ODCSOPS  (DAMO-RQR). 

(2)  Includes  air,  sea,  and  LOC  loss  factors. 

(3)  Specifies  percent  of  MIE  shipped  by  air. 

(U)  Includes  prestock  and  depot  stocks  time  in  days. 

e.  Red  Artillery  Systems 

(1)  Compatible  with  systems  played  in  CEM. 

(2)  Includes  tubes,  MRL,  and  heavy  mortars. 

f.  Lethality  Data  by  Red  System  by  Vulnerability  Category 


Provided  by  AMSAA. 

Includes  data  for  conventional  and  ICM  shells  by  type  of  fuze 
tube  and  three  environments  (open,  woods  and  town  for  each 
equipment  vulnerability  class  and  personnel). 

ae  Unit  Data  (target  complexes) 

Each  type  unit  is  extracted  from  the  map  arrays  supporting  the 
study  to  compile  a  TOE/SRC  list.  This  includes  all  levels  of 
organizations  (D1V  HHC,  BDE,  ARC,  MECH,  INF  BN,  MECH  INF 
CO,  MECH  INF  PLT,  etc.)  to  include  those  nondivisional  units 
located  in  the  division  area. 

Using  an  automated  TOE  file  developed  by  CAA  (Support  Forces 
Group,  FAD),  each  type  unit  is  queried  for  equipment  listing  and 
quantity,  then  scrubbed  by  the  MIE  list. 

Equipment  attrition  is  properly  addressed  as  each  type  unit 
reflects  actual  TOE  authorization  with  correct  quantities. 
Equipment  not  on  the  MIE  list  is  removed. 
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h. 


Acquired  Target  List 


(1)  Same  acquired  target  list  generated  in  support  of  the  AMMO 
RATES  Study. 

(2)  This  list  is  recoded  to  reflect  the  correct  type  unit  identifier  and 
is  passed  to  WARF-RAM. 

i.  Time  Periods 


(1)  Provided  by  ODCSOPS  (DAMO-RQR). 

(2)  Normally,  the  seven  basic  time  periods  are  specified  and  drive  all 
other  time-oriented  inputs  such  as  density  and  quantity  profiles. 

(3)  For  report  purposes,  up  to  10  time  periods  can  be  specified. 

POSTPROCESSOR  ORGANIZATION:  The  study  flow  includes  the 

preparation  of  the  three  prime  automated  simulations:  CEM,  WARF/RAM, 
(or  WIMP)  and  ELCON.  Other  automated  utility  routines  are  used  in 
establishing  proper  format  of  data  or  extracting  output  from  the  simulation 
models.  A  normal  WARF  study  parallels  the  ammo  rates  methodology  and 
assumptions  concerning  the  theater  model  (CEM)  are  shared.  The  only 
difference  between  these  two  efforts,  at  theater  level,  is  the  addition  of  an 
unconstrained  LOG  file  in  the  CEM.  All  other  inputs  to  CEM  used  to 
develop  an  ammo  rates  base  case  are  unchanged  for  the  WARF  base  case. 
Four  outputs  of  this  simulation  are  used  as  inputs  to  ELCON:  scenario 
(percent  of  the  US  force  in  each  combat  posture  for  each  of  the  WARF  time 
periods);  loss  rates  for  each  weapon  system  (designated  as  a  CEM  category 
per  time  period);  average  division  strength  (number  of  flags)  per  time  period; 
and  capability  of  Red  artillery  for  each  time  period.  The  first  three  outputs 
are  extracted  using  automated  utilities  and  the  fourth  is  manually  computed 
using  the  CEM  Logistic  Report. 

Preparation  of  the  WARF-RAM  begins  well  before  the  finalization  of  a  CEM 
played  and  the  appropriate  lethality  data  for  each  tube  for  HE  and  ICM 
shells.  AMSAA  must  be  provided  the  tubes  (and  mortars)  by  caliber  to 
develop  the  lethality  data  for  each  of  the  22  vulnerability  categories.  Also 
needed  is  the  ammo  rates  acquired  target  list  recoded  to  reflect  the  type 
unit  information  discussed  in  paragraph  l.c  of  this  Section;  there  are  four 
units,  vulnerability  categories,  and  quantity  must  be  constructed  so  that 
WARF-RAM  can  output  loss  rates  by  posture  by  vulnerability  category.  The 
WARFRAM  Model  is  normally  operated  by  the  Study  team's  Artillery  Model 
Analyst.  Under  WARRAMP,  the  WARFRAM  eventually  will  be  replaced  by 
the  WARRAMP  WARF  Intermiate  Material  Processor  (WIMP).  An  explana¬ 
tion  of  the  WIMP  can  be  found  in  Section  III,  Chapter  2.  As  of  the 
publication  of  this  document,  the  WIMP  is  operational  but  can  not  be  used  in 
a  study  due  to  the  arraying  of  combat  and  support  units  found  in  the  Division 
Area  (0-30  KM  from  the  ZEBA).  When  the  compiler  testing  and  arraying  is 
completed,  the  WIMP  will  be  permanently  installed,  replacing  WARF/RAM. 
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ELCON  is  the  repository  for  all  data  mentioned  so  far.  In  addition,  the  data 
covered  in  paragraph  3.1,  Chapter  3,  is  input  to  ELCON  as  stated  by  the 
documentation. 

The  last,  and  largest,  input  is  the  equipment  file.  This  includes  the 
L1NCODE,  nomenclature,  vulnerability  category  (CEM,  WARF-RAM  (Or 
WIMP)  and  historical)),  depot  stockage,  percent  shipped  by  air,  sequence 
number,  and  quantity  and  density  profiles  for  each  M1E.  Documentation  for 
this  is  also  covered  in  the  -  explanation  of  ELCON. 

SYSTEM  FLOW:  The  normal  flow  begins  with  the  creation  of  the  automated 
equipment  file.  ODCSOPS  provides  a  hard  copy  listing  of  the  LIN  codes  and 
nomenclatures  which  are  keypunched  into  a  computer  file  called 
LINCODE/L1ST.  When  available,  the  proper  equipment  loss  code  (CEM 
number,  vulnerability  category,  historical  class)  is  added  to  this  file 
(referred  to  as  Item  Record  Type  A).  Item  Record  Type  B  and  C  can  be 
constructed  when  LEA  furnishes  the  quantity  and  density  profiles  tape.  The 
utility  LEA/TAPE  is  used  to  read  this  tape  and  create  a  raw  data  file  from 
which  a  Type  B  and/or  C  record  can  be  built.  Other  utilities  are  used  to 
complete  this  requirement. 

When  the  array  effort  is  completed  for  each  posture,  the  type  unit  file  can 
be  initiated.  Each  organization  that  can  pose  as  a  target  must  be  repre¬ 
sented.  The  Support  Forces  Group,  Force  Development  Directoriate,  CAA, 
generates  a  TOE  file,  from  force  accounting  data,  that  is  used  to  complete 
the  type  unit  file.  However,  organizations  below  company  level  must  be 
developed  by  utility  and  manual  edited  as  no  data  exists  in  the  TOE  file  for 
platoons  or  squads.  Again,  various  utilities  are  used  to  organize  the  type 
unit  file  by  unit,  LIN  code  of  authorized  equipment,  and  quantity.  After 
completion,  a  scrub  is  made  to  delete  any  equipment  that  does  not  match 
the  MIE  list.  The  final  type  unit  file  is  used  to  construct  the  matrix  of  type 
units  required  by  WARF-RAM  (or  WIMP). 

When  the  acquired  target  lists  are  available  from  the  AMMO  RATES  TAM 
process,  target  numbers  and  type  unit  associations  must  be  completed.  If 
WARF-RAM  has  the  correct  Red  type  artillery  and  lethality  data,  then  with 
the  addition  of  the  matrix  of  type  units  and  corrected  acquired  target  lists, 
computation  of  the  loss  rates  by  vulnerability  category  by  posture  can  be 
completed.  Under  WARRAMP  COSAGE  replaces  such  high  resolution 
models  as  the  TAM/RAM  formally  used  in  AMMO/WARF  Rate  Method¬ 
ology.  Thus,  the  WIMP  was  developed  to  operate  with  COSAGE  replacing 
WARFRAM  methodology.  The  COSAGE  provides  data  to  WIMP  on  Red 
Artillery  fire  missions  and  uses  this  data  to  compute  blue  personnel  and 
equipment  losses.  The  WIMP  methodology  thus  will  provide  all  the  current 
data  previously  developed  by  WARFRAM. 

Finally,  with  the  conclusion  of  a  CEM  WARF  base  case,  the  scenario,  CEM 
losses,  division  flag  count,  and  Red  artillery  degradation  factors  can  be  input 
to  ELCON  and  initial  WARF  rates  can  be  produced. 


Figures  II. 2. 1  -  II.2.9,  Section  II  graphically  detail  the  system  flow  of  the 
MPP.  Each  utility  found  in  the  MPP  is  identified  along  with  each  file  that  is 
used  as  input  and  produced  as  output. 
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LEA/TAPE 


Figure 


MPP  FLOW-8 


MPP  FLOW-9 


*  The  WIMP/MATRIX  program  may  be  named  in  lieu  of  RAM/MATRIX 

Figure  11.2.9 
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SECTION  III 


Chapter  1 

EOUIPMENT  LOSS  CONSOLIDATOR  (ELCON) 

DESCRIPTION  -  The  purpose  of  the  Equipment  Loss  Consolidator  (ELCON) 
is  to  combine  equipment  loss  data  from  historical  and  computer  simulation 
sources  with  current  equipment  deployment  and  vulnerability  information, 
as  calculated  in  the  MPP,  in  order  to  compute  expected  monthly  loss  rates 
for  a  list  of  specific  equipment  items.  Within  a  single  execution  of  the  pro¬ 
gram  up  to  20  sets  of  loss  rates  over  a  combination  of  time  periods  can  be 
calculated.  A  complete  discussion  of  the  ELCON  process  can  be  found  in 
document  CAA-D-79-3,  August,  1979,  entitled  "Equipment  Loss  Consolida¬ 
tor  (ELCON)"  which  is  referenced  in  Appendix  B. 

STRUCTURE  -  The  overall  structure  of  this  program  is  pictured  in  Figure 
III. 1.1. 

DATA  BASE  -  The  data  base  which  supports  the  ELCON  program  consists 
of  six  files  of  which  three  are  used  as  input  and  three  as  output.  The  input 
files  are  the  CONTROL/XX  file,  produced  by  the  CONTROL/COMPILER 
utility,  ITMID/FINAL  file,  produced  by  the  ITMID/REC-A  utility,  and  the 
HISTORICAL  SYMWAR  FACTORS  file,  which  is  based  upon  historical  data 
gathered  from  World  War  II  and  Korean  War  and  limited  Vietnam  exper¬ 
iences.  The  three  output  files  are  the  R ATES-XX/SEC-1,  which  summar¬ 
izes  the  CONTROL/XX  input  file  using  a  simular  format.  The  RATES- 
X X /MONTHLY- WOL  which  contains  the  monthly  in  theater  losses  (exclu¬ 
ding  inter-theater  shipping,  LOC,  (intra-theater  shipping  losses)  and  depot 
losses),  and  the  R ATES-XX/MONTHLY-WL  contains  the  monthly  total  loss 
rates  including  the  inter-theater  shipping,  LOC  (intra-theater  shipping 
losses)  and  depot  losses.  Each  file  will  be  discussed  in  more  detail  in  the 
following  INPUT  and  OUTPUT  sections. 

RUNSTREAM  -  The  runstream  which  is  used  to  control  the  execution  of 
this  program  is  pictured  in  Figure  III.  1.2.  The  runstream  is  presently  cata¬ 
loged  as  an  element  under  the  program  file  CSTART*82XQT  using  the  ele¬ 
ment  name  ELCON/3.  As  the  runstream  executes  it  accomplishes  the  fol¬ 
lowing  functions: 

o  Assigns  to  the  logical  unit  88  the  current  study's  program,  in  this  case 
SECRET*82WARFP88. 

o  In  the  line  2  the  user  is  required  to  supply  the  program  file's 
Read/Write  key  between  the  two  slashes  (88/  /  .)  in  order  to  gain 

access  to  the  file. 

o  Assigns  to  the  logical  unit  4  the  file  which  contains  the  SYMWAR  hist¬ 
orical  rate  factors  derived  from  WWII,  Korean  War  and  limited 
Vietnam  experiences.  In  this  current  example  the  file  is  cataloged  as 
the  program  file  "XXHISFAC". 
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o  Using  the  system  editor  the  CONTROL/XX  file  and  the  ITMIH/F1NAL 
file  under  the  present  study's  program  file  are  assigned  to  logical  unit 
5.  The  XX  portion  of  the  control  file  must  be  changed  to  reflect  the 
appropriate  CEM  Run  Control  Number.  This  number  can  he  obtained 
from  the  CEM  Operator/Analyst.  It  will  also  be  used  in  the  creation  of 
the  CONTROL  file  bv  the  CONTROL/COMPILER  program. 

o  The  program  itself  is  cataloged  as  an  element  under  the  program  file 
82XQT  using  the  elemenet  name  ELCON/3.  The  runstream  next 
assigns  the  program  file  and  element  and  executes  the  program. 

o  The  results  of  the  program  collected  in  logical  unit  6  are  copied  to  the 
permanent  file  R ATES-XX/SEC-1.  Those  collected  in  unit  7  are 
copied  to  RATES-XX/MONTHLY-WOL,  and  the  contents  of  unit  8  are 
copied  to  RATES-XX/MONTHLY-WL.  The  "XX"  portion  of  the 
element  name  must  also  be  changed  to  the  current  CEM  Run  Control 
Number.  The  files  are  also  cataloged  under  the  current  study's 
program  file  designated  by  unit  88. 

o  All  units  allocated  during  the  execution  of  the  utility  are  released. 
Each  type  of  equipment  in  the  battle  area,  its  density  per  time  period, 
and  the  faction  of  the  total  amount  of  equipment  to  be  found  in  each 
of  the  five  combat  zones  per  time  period.  This  file  is  produced  by  the 
1TM10/REC-A  utility  of  the  MPP.  A  complete  discussion  of  the  file 
and  the  three  record  types  which  consititute  it  can  be  found  in  Appen¬ 
dix  P>,  document,  CAA-D-79-3,  ELCON,  pages  4-5  and  4-6. 

.5  INPUT  -  The  ELCON  uses  three  files  as  its  inout.  These  files  are  the  His¬ 
torical  SYMWAR  Factors  file,  1TMID/F1NAL  file  and  the  CONTROL/XX 
file.  Each  file  is  discussed  below: 

o  Historical  SYMWAR  Factors  file  -  The  equipment  loss  data  found  in 
this  file  is  derived  from  analysis  of  WWI1,  Korean  War  and  limited 
Vietnam  experiences.  This  file  is  cataloged  under  the  program  file 
82HISFAC.  within  the  system.  As  the  data  here  reflect  historical  ex¬ 
periences  it  is  static,  thus  the  user  is  not  required  to  update  it.  A  de¬ 
tailed  explanation  of  the  file  structure,  record  layouts  and  data  exam¬ 
ples  can  be  found  in  the  USACAA  document  CAA-D-79-3,  ELCON, 
pages  4- 1,4-2,  and  C-l  through  C-4. 

o  ITMID/FINAL  -  This  file  will  contain  data  which  describes  each  tvpe  of 
equipment  in  the  battle  area  giving  for  example,  its  LINCODE,  nomen¬ 
clature,  vulnerability  category,  etc.  Also  provided  is  the  quantity  of 
this  item  authorized  and  the  density  or  distribution  fraction  of  this 
item  within  each  of  the  five  zones  of  the  combat  area  for  each  of  the 
seven  time  periods  of  the  study.  This  file  is  a  product  of  the  ITM1H/- 
REC-A  utility.  Figure  III. 1.3  presents  a  data  example  of  the  file. 
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FILE:  ITMID/FINAL 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  UTILITY /ITMID/RECA 

RECORD  FORMAT: 


Position  Description  Format 

1  Blank  IX 

2-7  Line  item  number  (LIN)  A6 

8  Blank  IX 

9-38  Alphanumeric  nomenclature  5(A6) 

39  Blank  IX 

40-91  Type  equipment  code  for  losses  12 

from  theater  model 

42  -  43  Vulverability  class  for  losses  12 

from  artillery  model 

44  -  45  Classificatin  for  Historical  Data  12 

46  -  48  In-theater  dept  stockage  (number  13 

of  days  supply) 

49  -  50  Fraction  of  intertheater  shipment  F2.2 

which  is  by  air 

51-52  =  1  if  actual  equipment  density  is  12 

to  be  read  and  used 

=  0  if  density  is  to  be  estimated 


from  the  number  of  division  in  theater 

53  -  54  =  1  if  combat  losses  are  from  the  12 

theater  simulation 

=  2  if  the  combat  losses  are  from 

artillery  models 

=  3  if  all  losses  are  from  history 

Sequence  Number  14 

Quantities  of  this  line  item  for  7(17) 

the  seven  time  periods  of  the 
exercise,  obtained  from  the  new 
ITMID/TEMP  file. 

I  -  35  Density  Profiles  for  Time  Period  N  5(F 5.2) 

for  this  line  item  in  each  of  the 
five  zones  or  areas  being  played  in 
this  exercise.  These  density  profiles 
are  obtained  from  the  NEW  ITMID/TEMP 
file.  There  must  be  seven  occurrences  of 
this  record;  one  for  each  time  period 
being  played. 


55  -  58 
1  -  49 


o  CONTROL/XX  -  This  file  contains  such  information  as  run  control 
data,  the  equipment  loss  information  provided  by  combat  simulation 
(rather  than  historical  experiences),  Red  artillery  losses,  Blue  Division 
strengths,  etc.  This  file  is  a  product  of  the  CONTROL/COMPILER 
utility.  A  complete  discussion  of  this  file  can  bn  found  in  the  CON¬ 
TROL/COMPILER,  Chapter  16  of  this  document.  An  example  of  the 
data  can  be  seen  in  Figure  111.1.4,  Section  111. 

FILE:  CONTROL/XX 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  Utility  -  CONTROL/COMPILER 

RECORD  FORMAT: 

Position  Description  Format 

1  -  5  Number  of  time  period  on  which  15 

data  is  being  input. 

6-10  Maximum  sequence  number  of  list  15 

of  materiel  items. 

11-15  Number  of  types  of  items  on  which  15 

combat  loss  data  is  derived  from 
theater  simulation  (currently  CEM). 

16  -  20  Number  of  sets  of  loss  rates  to  be  15 

computed  for  each  item. 

21-25  =  0  if  historic  loss  matrix  has  not  15 

been  computed  for  each  item  and  per¬ 
iod  and  stored  in  previous  run; 

r  1  if  previously  computed  matrices 
are  read  on  Logical  Unit  2. 

26  -  30  Number  of  periods  for  which  replace-  15 

ment  equipment  is  prestocked. 

31  -  35  -0  for  short  printout;  15 

=  1  for  long  printout; 

=  -1  for  no  printout  (File  7  and 
8  output  only) 


Number  of  Records 

Description 

Format 

1  or  2  (as  needed) 

No.  of  days  in  each  time  period 

1615 

1  per  set  of  rates 

First  and  last  period  considered 
in  i  set  of  rates 

215 

1  or  2  (as  needed) 

Intertheater  loss  fraction  by  time 
period  for  air  shipment 

16F5.4 

1  or  2  (as  needed) 

Intertheater  loss  fraction  by  time 
period  for  sea  shipment 

16F5.4 

I  or  2  (as  needed) 

in-theater  LOC  loss  fraction  by 
time  period 

16F5.4 

1  or  2  (as  needed) 

Average  number  of  Blue  divisions 
in  theater  by  period 

16F5.2 

1  per  period 

Fraction  of  time  in  attack,  defense 
delay,  inactive  period  i 

4F5.2 

8 

For  each  posture  (attack,  defense, 
delay,  inactive),  2  records  with 
fraction  lost  per  day  of  each  of  22 
vulnerability  classes 

11F6.3 

1  or  2  (as  needed) 

Fraction  of  full  strength  Red  artil¬ 
lery  effetiveness  to  be  applied  by 
time  period 

16F5.2 

1  or  2  (as  needed) 
per  period 

Losses  from  theater  model  in  period 
i  for  each  type  of  equipment  con¬ 
sidered  in  theater  model  (expressed 
as  percent  lost  per  30  days) 

16F5.2 

1.6  OUTPUT  -  The  ELCON  program  is  capable  of  producing  three  output 
files.  These  files  are  the  RATES-XX/SEC-1,  RATES-XX/MONTHLY-WOL, 
and  RATES-XX/MONTHLY-WL.  The  XX  portion  of  the  file  name  will  be 
replaced  by  the  appropriate  CEM  Run  Control  Number.  This  number  is 
obtained  from  the  CEM  Operator/Analyst.  The  user  will  change  the  file 
names  to  reflect  this  CEM  run  control  number  in  the  runstream  using  the 
system  editor.  Each  output  file  will  be  discussed  below. 

o  RATES-XX/SEC-1  -  This  file  will  be  produced  only  if  the  PRINT  INDI¬ 
CATOR,  i.e.,  Columns  31-35  of  the  Run  Parameters  Record  in  the 
CONTROL-XX  file  is  set  to  either  "0"  or  "1".  A  sample  is  presented  in 
Figure  III.  1.5.  If  it  is  set  to  "-  1",  this  file  will  not  be  produced.  This 
file  is  used  to  collect  output  for  the  ELCON  program  and  format  it  for 
printing  so  that  it  is  understandable  by  the  combat  analyst.  As  noted 
above,  the  user  will  have  the  option  to  specify  the  level  of  detail  that 
will  be  contained  in  the  file.  If  the  user  enters  a  "1"  in  the  Print  Indi¬ 
cator  file  of  the  Run  Parameter  Record  the  user  will  obtain  a  detailed 
report  as  output.  This  report  will  contain: 


oo  A  replay  of  the  CONTROL-XX  file  that  was  used  as  input  to  the 
program  with  the  addition  of  heading  information  explaining  the 
data  which  follows  it. 

oo  A  detailed  analysis  of  the  loss  rates  consolidated  from  the  histor¬ 
ical  data  and  the  results  of  the  theater  simulation  for  each  piece 
of  major  equipment  being  played  in  the  study.  Included  here  is 
the  Density  Profiles,  loss  rates  from  each  of  the  10  historical 
causes,  losses  in  depot,  etc.  A  complete  example  of  a  typical 
report  can  be  found  in  the  ELCON  documentation,  CAA-D-79-3, 
pages  D1  through  D-12. 

oo  If  the  user  enters  a  "0"  into  the  Print  Indicator  field,  a  shortened 
version  of  the  report  will  be  prepared.  This  version  will  include 
the  formatted  replay  of  the  CONTROL-XX  file  identical  to  that 
portion  of  the  detailed  output  discussed  above  plus  an  item  by 
item,  one-line  summary  of  each  piece  of  equipment  being  played. 
This  summary  high-lights  the  equipment  line  code,  name,  WARF 
set  (which  is  defined  as  a  continuous  period  of  time  within  the 
model  delineated  by  a  start  period  and  an  end  period)  and  the  loss 
rates  broken  out  by  in-theater  losses  and  inter-theater  losses. 
An  example  of  this  output  can  also  be  found  in  the  US  AC  A  A  doc¬ 
ument  CAA-D-79-3,  pages  D-13  through  D-15,  Appendix  B. 

o  RATES-XX/MONTHLY-WOL  -  This  file  is  always  produced  by  the 
ELCON  program.  The  file  details  for  each  item  of  equipment  in  the 
study  the  monthly  in-theater  loss  rates  (excluding  inter-theater 
shipping,  LOC  (fntra-theater  shipping  losses)  and  depot  losses)  for  each 
WARF  set  or  time  frame  specified  by  the  user.  Figure  III.  1.6  present 
the  record  layout  and  examples  of  the  data  found  in  the  file. 

FILE:  RATES-XX/MONTHLY-WOL 

STORAGE:  Mass  Storage 

SOURCE:  ELCON 

RECORD  FORMAT: 


Column 

Description 

Format 

1 

BLANK 

IX 

2-7 

L1NCODE 

A6 

30 


8 


BLANK 


IX 


Nomenclature 


39-86 


Monthly  loss  rates  of 
this  item  for  each  time 
period  in  the  study.  These 
rates  are  calculated  exclud¬ 
ing  LOC  and  Depot  losses. 


8(F6.2) 


R  ATES-XX/MONTHL  Y-'VL  -  This  file  is  similar  to  the  above  WOL  file 
except  that  it  contains  the  total  loss  rates  for  LOC,  depot  and  inter¬ 
theater  shipping  losses  for  each  WARF-set  identified  by  the  user.  This 
file  always  is  produced  by  the  ELCON  utility.  Figure  III.  1.7  depict  the 
record  layout  and  examples  of  the  data  contained  in  the  file. 

FILE:  RATES-XX/MONTHLY-WL 
STORAGE:  Mass  Storage 
SOURCE:  ELCON 

RECORD  FORMAT: 


Column 


Description 


Format 


BLANK 


LINCODE 


BLANK 


39-86 


Nomenclature 


Monthly  loss  rates  of 
this  item  for  each  time 
period  in  the  study.  These 


8(F6.2) 


I 


Message: 

Cause: 

Solution: 

Message: 

Cause: 


rates  are  calculated  using 
LOC,  Depot  and  inter-theater 
shipping  losses. 


These  three  output  files  will  be  used  in  conjunction  with  the  ITMID/- 
FINAL  file,  produced  by  the  IMID/REC-A  utility  (Chapter  5)  to  produce 
the  Final  Report  which  expresses  loss  rates  in  daily  terms. 

PERFORMANCE  -  In  order  to  execute  successfully  the  ELCON  program 
requires  the  following  system  resources: 


CORE: 

CPU  TIME: 
CLOCK  TIME: 
DISK  UNITS: 
COMMENTS: 


10K 

1  5  MIN  OR  LESS 
20  MIN  OR  LESS 
1  -  3 
NONE 


ERROR  CONDITIONS  -  The  ELCON  program  has  built  into  it  four 
tests  for  input  errors.  Upon  detection  of  an  error  a  short  explana¬ 
tory  message  which  identifies  the  problem  will  be  written  to  the 
R ATES-XX/SEC-1  file  and  in  three  of  the  four  cases  stop  execu¬ 
tion.  Each  error  condition  will  be  discussed  below: 


ERROR  1 

SEOUENCE  //  item  seq.no.  LARGER  THAN  MAX  SPECIFIED 

/ 

The  sequence  number  assigned  to  this  equipment  item  is  greater 
than  the  maximum  specified  by  the  user  in  the  second  field  of  the 
Run  Parameter  Record  of  the  CONTROL-XX  file. 

Using  the  system  editor  access  the  ITMID/FINAL  file  and  deter¬ 
mine  the  sequence  number  of  the  last  equipment  item  of  the  file. 
This  number  is  denoted  by  the  last  field  of  the  "A"  or  header 
record  of  the  equipment  item.  With  this  number  again  using  the 
system  editor,  access  the  Run  Parameter  Record  of  the 
CONTROL-XX  file  and  change  the  maximum  sequence  number. 

ERROR  2 


SEQUENCE  //  item  seq.  no.  MARKED  AS  CEM  ITEM  W/O  CAT 
CEM 

The  header  or  "A"  record  of  the  item  of  equipment  in  the  ITMID/- 
FINAL  file  indicates  that  the  combat  losses  for  this  item  will 
come  from  CEM  but  the  CEM  category  used  to  identify  the  type 
of  equipment  for  losses  from  the  theater  model  (CEM)  has  not 
been  specified. 
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Solution:  Notify  CEM  Operator/Analyst  of  discrepancy.  If  in  fact  this  item 

is  a  CEM  item,  user  must  determine  the  appropriate  CEM 
category  and,  using  the  system  editor,  enter  in  the  appropriate 
CEM  category  type  code  for  this  item  in  the  third  field  (i.e., 
positions  40-41,  left  justified)  of  the  item's  header  record  of  the 
ITMin/FINAL  file. 

If  it  is  determined  that  the  item  is  not  a  CEM  item  the  user  must 
again  access  the  header  record  of  the  item  in  the  ITMID/FINAL 
file  and  change  the  last  field  (i.e.,  positions  53-54,  left  justified) 
to  a  2  (if  combat  losses  ar  from  artillery)  or  a  3  (if  combat  losses 
are  from  historical  data). 

ERROR  3 

Message:  SEQUENCE  //  item  seq.  no.  MARKED  AS  ARTY  JTM  W/O 

CATART 

Cause:  The  header  or  "A"  record  of  the  item  in  the  ITMID/FINAL  file  has 

indicated  in  the  ninth  field  (i.e.,  positions  53-54)  that  the  losses  of 
this  item  will  be  from  artiiery  but  no  artilery  vulnerability  class 
has  been  specified  for  the  item  in  the  fourth  field  of  the  record 
(i.e.,  positions  42-43). 

Solution:  Determine  whether  or  not  losses  for  this  item  are  in  fact  to  be 

determined  by  artillery.  If  not  using  the  editor,  change  the  ninth 
field  (i.e.,  positions  53-54,  left  justified)  to  the  appropriate  loss 
code  1  =  theater  simulation  (CEM);  3  =  historical. 

If  the  loss  is  to  be  from  artillery,  determine  the  appropriate  vul¬ 
nerability  category  for  the  item  from  the  22  available  and  using 
the  editor  enter  it  into  the  fourth  field  on  the  header  record  (i.e., 
positions  42-43,  left  justified). 

ERROR  4 

Message:  ITEM  //  item  seq.  no.  HAS  ILLEGAL  HISTORICAL  CLASS 

Cause:  For  the  program  to  reach  this  error  message  the  ninth  field  (posi¬ 

tions  53-54)  of  the  header  record  of  the  ITMID/FINAL  file  must  be 
set  to  3  (i.e.,  all  losses  are  from  history)  and  the  historical  class 
identifier  is  not  between  1  and  36  and  is  thus  illegal.  This  error, 
unlike  the  other  3,  will  not  cause  the  program  to  stop  execution. 

Using  the  Item  Sequence  Number  and  the  system  editor  examine 
the  header  record  for  this  item,  determine  the  appropriate  histor¬ 
ical  class  (i.e.,  a  number  from  1  to  36)  and  enter  it  into  columns 
53-54  right  justifying  the  entry. 


Solution: 


unclassified*«»file  name:cstart»82xgt  element  nahe:elcon/3»»»unclassified 


i:aUSE  88..SECRET.82RCK87. 

2:3ASG.A  88/  / 

3:3ASG»T  6..///20Q 
4tSASG.T  7..///200 
5:a*SG.T  8..///200 
6:aASG.T  2..///500 
7:aASC.A  82HISFAC. 

8:aASG.T  4..///200 
9  !8ED  82HISFAC..4. 
iOIEXIT 

lltaMSG.N  THE  A80VE  DATA  FILE  *  82HI SFAC*  HOLDS  THE  HISTORICAL 
12:8MSG.N  SYMWAR  FACTORS. 

13:aASG.T  5..///S00 
14:aED.I  5. 

is: 

16:aOD«  88  .CON  TR  CL /XX 

it:aco*  88. i th id /final 
18:exit 

19:aMSG.N  THE  ABOVE  ELEMENT  FILES  "CONTROL/XX*  AND  *ITMID/FINAL"  ARE 
20:aMSG.N  OUTPUT  OF  •  32XQT.C0  NT  ROL/COMPILER*  AND  *  82XGT  .  ITMID/REC-A  ■  . 
2i:aMS0.N  ALONG  WITH  THE  OATA  FILE  '82HTSFAC"  THESE  FILES  PROVIDE 
22:8MSG.N  ALL  THE  INPUT  OATA  NECESSARY  FOR  THE  COMPUTATION  OF 
23:aMSG.N  NARF  ATTRITION  RATES. 

2»:aASG.A  82XQT. 

2S:aXOT  82X0T.ELC0N/3 
2G:aED  2.  .88.H0L0-XX 
27:exit 

28:aMSG.N  THE  A80VE  ELEMENT  'HOLD-XX*  IS  USED  TC  STORE 
29:aMSG.N  WARF  MARTIX  CALCULATIONS  AN"  CAN  BE  REUSED  TO 
30:aMSG.N  COMPUTE  LOSS  RATES  FO  R  A  RERUN  OF  THE  ELCON  FOR 
3i:aMSG.N  THE  SAME  RUN.  FOR  FURTHER  GUIDANCE  SEE  THE  ELCON 
32  :  a  MS  G  t  N  PROGRAMMERS  MAINTENANCE  MANUAL. 

33!SEO  S.  .8  8.  RATE  S-XX /SEC-1 

34  :p  20 

35IEXIT 

36  :8E0  7..  88.  RATES-  XX/M ON THLY-W  CL 

37tP  20 

38IEXIT 

39:8ED  8. *88. RAM  S-XX/MONTHLY-VL 

ao:p  20 
ai:exit 

42:aMSG.N  THE  ABOVE  ELEMENT  FILES  CONTAIN  THE  OUTPUT  DATA  FROM  THIS 
43 18MS  G*  N  UTILITY.  ALL  RATES  ARE  EXPRESSED  IN  MONTHLY  TERMS.  THIS 
44:8MSG.N  OATA  WILL  BE  USE  AS  INPUT  8Y  THE  UTILITY  *  82XQT  .FINAL/REPORT* 
45:8MSG.N  •  WHICH  WILL  CONVERT  THE  MONTHLY  RATES  TO  DAILY.  THE  ’XX* 

46iaMSG.N  IN  THE  ELEMENT  NAMES  MUST  CORFSPOND  TC  THE  APPROPRIATE 
47:aHSG.N  CEM  RUN  CONTROL  NUMBER. 

48:aFRE£  2. 

49  !  BFR  EE  4. 

50 ISFR  EE  5. 

51 :  a  FR  EE  6. 

52 :  BFR  EE  7. 

53  : BFR  EE  8. 

54  :aFR ee  as. 


Figure  III.  1.2 


UNCLASSIFI£D»*»£*AMPLf  OF  THE  OUTPUT  OP  UTILITY  ITHIO/REC-A999UNCLASSIFICD 


1.* 

90  3198  AK 

VEH  N21 8  GM  ES  P1A 

0  522 

30  0 

1 

2 

1 

2: 

59 

69 

99 

58 

78 

88 

88 

F 

3: 

.00 

.00 

.00 

.80 

.20 

■*: 

.00 

.00 

.00 

.80 

.20 

i 

5: 

.00 

.00 

.00 

.80 

.20 

f 

e : 

.00 

.00 

.00 

.80 

.20 

1 

7: 
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.00 

.00 
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a : 

.00 

.00 

.00 

.80 

.20 

] 

9: 

.00 

.00 

.00 

.75 

.25 

j 

10 : 

A197  52 

AOAP  TEST  CAMERA  LM178 

01636 

30  0 

1 

2 

2 

1 

11: 

10 

16 

16 

17 

17 

17 

17 

175 

.00 

.00 

.20 

.80 

.00 

13: 

.00 

.00 

.20 

.80 

.00 

* 

19 : 

.00 

.00 

.20 

.80 

.00 

157 

.00 

.00 

.  15 

.85 

.00 

16: 

.00 

.00 

.15 

•  8  5 

.00 

17: 

.00 

.00 

.  35 

.65 

.00 

la : 

.00 

.00 

.  35 

.65 

.00 

19: 

A2  29  96 

AIMING  CIRCLE 

M2  H/E 

01636 

30  0 

1 

2 

3 

20 : 

6615 
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8823 
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8823  8978 

21: 
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.25 

.50 

.00 

.00 

22: 

.25 

.25 

.50 

.00 

.00 

23: 

.25 

.25 

.50 

.00 

.00 

29: 

.25 

.25 

.SO 

.00 

.00 

2s: 

.25 

.25 

.50 

.00 

.00 

26: 

.25 

.25 

.50 

.00 

.00 

27 : 

.25 

.25 

.50 

.00 

.00 

28 : 

A2 3770 

AIR 

CONO 

FL/UNOM  6000  B 

01833 

30  0 

1 

2 

9 

29: 

0 

0 

0 

0 

0 

0 

0 

30 : 

.00 

.00 

.00 

.00 

.00 

31 : 

.00 

.00 

.00 

.00 

.00 

32*. 
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CHAPTER  2 


WARF  INTERMEDIATE  MATERIEL  PROCESSOR 


2.1  DESCRIPTION  -  The  purpose  of  this  utility  is  to  calculate  catastrophic  (hon- 
repairable)  losses  to  major  items  of  equipment  and  personnel  (not  evaluated 
in  the  Concepts  Evaluation  Model)  resulting  from  Red  Artillery  firing  on 
Blue  Units  in  the  Combat  Sample  Generator  (COSAGE).  This  utility  replaces 
the  WARF  RAM  methodology  for  computing  indirect  fire  losses  used  in 
previous  AMMO/WARF  Studies  (P-8  5,  P-86  and  P-87).  This  utility  is  the 
onlv  one  in  the  MPP  which  is  written  in  S1MSCR1PT  11.5. 

The  use  of  WARF  RAM  in  place  of  the  WARF  Intermediate  Materiel  Pro¬ 
cessor  (WIMP)  is  noted  throughout  the  text  of  this  manual  due  to  the  fact 
that  as  of  publication  date,  the  Combat  Support  Units  (i.e.,  AG  Company, 
TMT  Company,  Combat  Engineer  Company,  etc.)  will  not  be  arrayed  in  the 
COSAGE  stylized  units  arrays.  A  modification  of  the  COSAGE  Compiler, 
which  will  permit  the  use  of  more  computer  core,  thus  allowing  the  arraying 
of  these  units  is  completed.  With  this  modification  the  WIMP  will  be  perm¬ 
anently  installed  and  used  in  place  of  WARF  RAM  in  the  WARRAMP  WARF 
methodology. 

Additionally,  modifications  to  COSAGE  such  as  the  addition  of  TACA1R 
modules  and  capability  will  result  in  further  modifications  in  this  utility  to 
handle  the  calculation  of  losses  of  blue  M1E  and  personnel  resulting  from 
Red  TACAIR. 

The  utility  consists  of  nine  routines  in  addition  to  its  preamble.  Nine  of 
these  routines  bring  data  from  input  files  into  the  program  and  prepare  it  for 
processing  by  the  WARF  ARTY  routine.  The  WARF  ARTY  routine  calcu¬ 
lates  the  actual  catastrophic  losses  to  personnel  and  the  22  equipment  vul¬ 
nerability  categories  for  each  blue  unit  fired  upon  by  Red  Artillery.  The 
output  of  this  utility  is  used  by  the  utility  WIMP/LOSS-RATES  to  compute 
the  loss  rate  for  personnel  and  the  22  equipment  vulnerability  categories  by 
posture.  The  output  of  WIMP/LOSS-RATES  is  then  manually  placed  in  lines 
25-32  of  the  CONTROL/TEMP  input  data  file  used  by  the  utility 
CONTROL/COMPILER. 

2.2  STRUCTURE  -  Figure  Ml. 2.1  demonstrates  the  overall  structure  of  this 
utility.  From  the  diagram  it  can  be  seen  that  five  input  files  are  produced 
specifically  for  the  WARF  Intermediate  Processor. 

2.3  DATA  BASE  -  The  data  base  which  supports  this  utility  consists  of  eleven 
basic  files.  Six  of  the  files  are  obtained  from  the  COSAGE  Data  Base. 
These  six  files  (BTRY)XXX,  CATTU,  TBTRY,  PEM,  UNITXXX  AND  MUNS) 
are  input  files  used  by  COSAGE.  The  files  are  copied  by  the  WARF  analyst 
(on  a  terminal  via  the  System  Editor  from  the  COSAGE  files  and  used  in 
their  original  format.  The  next  three  files  EQUIP,  HELA,  and  SUBMUNS  are 
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in  the  same  format  as  the  COSAGE  input  files  EQUIP,  HELA,  and 
SUBMUNS,  but  must  be  modified  by  the  WARF  Analyst  to  reflect  personnel 
and  22  equipment  classes;  HE  catastrophic  lethal  areas;  and  DP  catastrophic 
lethal  areas.  For  specific  instructions  on  the  data  and  construction  of  the 
files  mentioned  so  far  see  the  appropriate  sections  of  COSAGE  Data 
Requirement  Document,  CAA-D-80-8,  1st  Edition,  dated  1  Tune  80. 

The  next  input  file,  TOE-IN-XX,  is  created  by  the  utility  WIMP/TOE-IN*  for 
each  posture  using  the  input  files  UN1TXXX  and  RAM/MATRIX.  The  final 
file  E5S1MU4X-X  is  produced  during  each  run  of  COSAGE  for  WIMP.  It  con¬ 
tains  data  on  each  Red  fire  mission  for  a  posture. 

2.4  RUNSTREAM  -  Figure  MI. 2. 2  depicts  the  runstream  which  is  used  to  control 
the  execution  of  this  utility.  As  the  runstream  executes,  it  accomplishes  the 
following  functions: 

o  Establishes  a  Breakpoint  and  assigns  it  a  name  XXPRINT.  This  action 
will  open  logical  unit  number  6,  the  system  default  print  output  unit 
designator,  causing  output  to  be  directed  to  unit  6. 

o  Assigns  various  program  files  (i.e.  82  WIMP.,  82  WIMPDATA.) 

o  Assigns  the  output  file  also  the  logical  unit  called  SIMU3. 

o  Assigns  the  input  file  E5S1MUX-X,  to  the  logical  unit  called  SIMU4. 
(The  current  name  of  this  file,  must  be  obtained  from  the  CEM 
Operator/Analyst.) 

o  The  program,  which  is  located  in  the  element  S2WIMP,  ABs,  is 
executed. 

o  The  10  elements  or  data  files  used  as  input  to  this  program  and  are 
found  under  the  program  file  82WIMPDATA  are  added  sequentially  to 
the  input  file. 

o  Indicates  that  internal  to  the  program  references  to  88  will  mean  the 
program  file  82STUDY. 

o  The  contents  of  the  output  file  82WIMPOUT  are  copied  to  the  file 
88.WIMP/XX-X.  As  noted  in  the  runstream  the  "XX"  portion  of  this  file 
name  must  be  changed  by  the  user  to  reflect  the  proper  combat  posture 
(i.e.,  AT,  DE,  DI  or  DL)  of  the  study.  This  posture  code  must  cor¬ 
respond  to  the  posture  codes  of  the  four  posture  dependent  input  files, 
UNITXXX,  BTRYXXX,  and  TOE-IN-XX.  Further,  the  final  portion  of 
the  file  name  must  be  replaced  with  the  run  sequence  number. 

*  Currently  this  program  does  not  provide  authorized  personnel  quantities.  Rates 
are  not  being  computed  for  personnel  losses  by  WIMP  at  this  time,  although  the 
capability  has  been  developed  in  WIMP  to  do  so  in  the  future. 


o  Unit  88  is  released. 


o  The  Breakpoint  is  closed. 

o  Using  the  system  editor  the  print  file  XXPRINT  is  read  into  the  system 
for  editing. 

2.5  INPUT  -  The  input  to  the  WARF  Intermediate  Materiel  Processor  (WIMP) 
consists  of  eleven  basic  files.  Six  of  these  files  (CATTU,  UNITXXX,  DEM, 
TBTRY,  BTRYXXX  and  MUNS)  are  copies  of  the  COSAGE  input  files  of  the  same 
name.  Three  of  these  files  (EQUIP,  SUBMUNS  and  HELA)  are  similar  in  format 
and  content  to  the  COSAGE  input  files  of  the  same  name,  but  must  be  un¬ 
constructed  bv  the  WARF  analyst  to  reflect  22  Equipment  and  1  personnel  vulner¬ 
ability  category;  catastrophic  lethal  areas  for  each  equipment  and  personnel 
category  to  each  DP  submunition  and  HE  munition.  The  tenth  file  TOE-IN-XX  is 
created  for  each  combat  posture  by  the  utility  WIMP/TOE-IN  and  contains  the 
TOE  personnel  and  equipment  quantity  in  each  blue  unit  in  the  array  by  vulner¬ 
ability  category.  The  eleventh  file  is  created  exclusively  for  WIMP  and  provides 
data  on  each  Red  Artillery  fire  mission  executed  in  the  COSAGE  Simulation  for  a 
posture.  Each  of  the  eleven  files  will  be  briefly  discussed  below.  For  a  more 
detailed  explanation  of  the  first  nine  files,  see  the  COSAGE  Data  Requirements 
Document,  1st  Edition  CAA-D-80-8,  dated  1  3une  80. 

o  CATTU  -  This  file  contains  descriptive  data  on  each  type  of  combat 
unit  modeled  on  the  battlefield.  The  file  provides  such  data  as: 

-Type  of  Unit 
-Category  of  Unit 
-Distance  from  FEBA  of  Unit 
-Unit  rate  of  movement 
-Unit  Value  (Military  Worth) 

-Unit  radices 

-Principal  type  of  equipment 


This  file  is  copied  from  the  COSAGE  INPUT  Data  file  of  the  same 
name. 

This  file  is  read  into  the  system  by  the  CAT. TU. INPUT  routine. 

o  EQUIP  -  This  file  contains  data  which  identifies  each  type  of  equipment 
by  vulnerability  category  and  personnel.  This  file  is  created  by  the 
WARF  analyst  using  COSAGE  format  for  same  file. 

This  file  is  also  read  into  the  system  by  the  EQ.TE. INPUT  routine. 


U  3 


o 


UNITXXX  -  This  file  is  one  of  the  three  files  whose  contents  will 
change  depending  on  the  combat  posture  (i.e.,  Attack,  Detense  intense, 
Delay,  and  Defense  light).  Data  in  this  tile  describes  each  unit  in  the 
battle  area  for  a  particular  posture: 

Number  of  Units 
Unit  ID 

Unit  X,  Y  coordinates  within  battlefield. 

Unit's  parent  Unit 

Unit's  color  (i.e.,  Red  or  Blue) 

Weapons  assigned 
Weapon  status 
Weapon  quantity 


This  file  is  copied  from  the  COSAGE  input  file  of  the  same  name. 

This  file  is  read  into  the  system  by  the  UN1T.INPUT  routine. 

o  PEM  -  This  file  provides  information  to  the  program  on  the  current 
posture,  environment  and  mission  of  units  in  the  battle.  Contained  in 
this  file  is  the  appropriate  names  for  the  posture,  environment  and 
mission.  This  file  is  copied  from  the  COSAGE  input  file  of  the  same 
name.  This  file  is  read  into  the  system  by  the  P$E$M$INPUT  routine. 

o  TBTRY  -  This  file  provides  data  to  the  model  which  describes  the  type 
of  battery  which  is  firing  upon  the  Units.  This  file  is  read  into  the 
system  by  the  TB$INPUT  routine.  This  file  is  copied  from  the  COSAGE 
input  file  of  the  same  name. 

o  BTRYXXX  -  This  file  is  one  of  the  three  files  used  by  the  model  whose 
data  will  change  depending  on  the  particular  combat  posture  being 
modelled.  This  file  is  read  into  the  system  by  the  BTRY$1NPUT 
routine.  This  file  is  copied  from  the  COSAGE  input  file  of  the  same 
name. 

o  MUNS  -  This  file  will  provide  data  to  the  model  identifying  and 
describing  the  various  types  of  munitions  and  submunitions  that  will  be 
used  in  the  battle.  This  file  is  read  by  the  MUNS$INPUT  routine.  This 
file  is  copied  from  the  COSAGE  input  file  of  the  same  name. 

o  SUBMUNS  -  This  file  contains  data  which  describes  the  lethal  area  of 
DP  explosive  submunitions  against  WARF  personnel  and  equipment 
vulnerability  categories.  This  data  will  be  used  by  the  model  to  deter¬ 
mine  catastrophic  losses  of  blue  personnel  and  equipment.  This  file  is 
prepared  by  the  WARF  analyst  using  the  same  guidelines  as  documented 
for  the  COSAGE  input  file  of  the  same  name.  The  file  is  read  by  the 
SUBM$  INPUT  routine. 
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o  HELA  -  This  file  contains  data  which  describes  the  lethal  area  of  HE 
munitions  against  WARF  personnel  and  equipment  valuability  cate¬ 
gories.  This  data  wil  be  used  by  the  model  to  determine  catastrophic 
losses  of  blue  personnel  and  equipment.  The  file  is  prepared  by  the 
WARF  analyst  using  the  same  guidelines  as  documented  for  the 
COSAC.E  input  file  of  the  same  name.  The  file  is  read  by  the 
HE$LA$INPUT  routine. 

o  TOE-1N-XX  -  The  contents  of  this  file  will  change  depending  on  the 
particular  combat  posture  being  studied.  The  file  will  contain  data  on 
the  TOE  quantity  of  personnel  and  equipment  by  vulnerability  category 
authorized  each  blue  unit  arrayed.  The  file  is  created  by  the  utility 
WIMP/TOE-IN  which  is  explained  in  detail  in  Chapter  4. 

o  E5SIMUX-X  -  The  contents  of  this  file  will  change  with  each  posture 
and  run  of  the  COSAGE.  The  file  contains  a  variety  of  the  data  on  each 
Red  Artillery  file  mission  executed  within  COSAGE.  The  file  is  created 
exclusively  for  the  WIMP  and  its  exact  title  explanation  must  be 
acquired  from  the  COSAGE  analyst/operator. 

2.6  OUTPUT  -  The  OUTPUT  data  file  from  this  utility  82WIMPOUT  is  placed  in 
the  General  Study  file  under  the  element  name  WIMP/XX-X.  This  file  will 
contain  the  remaining  personnel  and  equipment  to  be  found  in  each  blue  unit 
which  was  not  attritted  by  Red  Artillery  fire.  This  file  will  be  used  as  input 
by  the  utility  WIMP/LOSS-RATES,  which  will  compute  the  loss  rates  for 
each  personnel  and  equipment  vulnerability  category  for  the  entire  blue 
force  arrayed. 

2.7  PERFORMANCE  -  In  order  to  execute  the  model  requires  the  following 
resources; 


o 

CORE; 

150K 

o 

CPU  TIME; 

5-10  MIN 

o 

CLOCK  TIME: 

10  -  15  MIN 

0 

DISK  UNITS; 

1  -  2 

o 

COMMENTS: 

CPU  ANO  CLOCK  TIME  VARIES  RY 
POSTURE 
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UNCLASSIF  1CL***F  Kt  NAML  :CSTART*8ZX0T  ELEMENT  NAME  :  k  IMP***UNCLA  SS I F 1  ED 
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: : i. t s g , a  PiUMPCM*. 

R  :  u  «  S  C  ,  A  ft  2  k  3  M  P  C  u  1 . 
f  :ir  25  8tWl**F0oT. 
t :  <■  A  SC  ,  A  ESSlvux-x. 
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A  SbH  &L  >  N  PREPARED  SPr C I F 1 C AL L Y  FOR  THE  .IMP.  THE  FILE  NAME 
StuMSC.N  HILL  NORMALLY  CHANGE  FOR  EACH  RUN  OE  CCSAGE.  CHECK 
1  "  :  ak  St.  ,N  «ITH  the  CG'AGE  ANAL YS T /OPE R A  TOR  FOR  THE  CORRECT 
1  1  : c  f.  ,  N  FIEF  NAME  FOR  each  RUN. 

1  2  :  b  0  S  t  S I“U3 ,? <U IMPOuT. 

13:<.LSE  S1HUR  ,E-jS  IMLX-X. 
lbtkXLT  A.kI«F.APS 
)!.:oAUC,LP  b2kIMPGATA.CATTU 
Jf:»ACc.LP  E'klMFUAlt.rcuIP 
17:<bALD,LF  b 2 k I MP 0 A T A . UNI  TOE F 
lfsuALT.LP  BZklMFOAIA.PEM 

1 ® : u  A  C  0 , L  r  fc2UlM PLATA. TbTPY 

At  0,LP  i2kIMFLATA.PT«YCCE 
2 1  : k  ALT  ,  Lf  b2WIHPt.ATA.HUNS 
?::c.AuO,LP  fcZklMPLATA.SubMUNS 
?!!«AJ.  ,LF  F2WlHrLATA.PEEA 
?R:»ALr  »LP  fcZklHF'ATA.  TOE-IN-** 

2S:»HSf,,N  ell  the  Above  atc  files,  except  "aRTYxxx",  "toe-in-xx", 

2(  :  k  M  SO  ,  ’J  ANU  "UMTXXX"  REMAIN  CONSTANT  FOR  EACH  RUN  or  The  hIMP 
?7 :  a  HSC  ,  N  F(1F  A  STUDY.  THE  OTFiER  THRrt  FILES  .ILL  CHANGE  FOR 

2  F  :  k  H  S  G  ,  N  EACH  FOSTUnT. 

2  S  :  k  L  St  E8. .RZTLOSAGE . 

JEtuASC,  A  Fb. 

3 1 : - F  L  82.IHPOUI . ,68.«IMP/XX-X 

I ; :  t  2  c 

3i:t AST 

3  M  :  E  x  I  T 

3S:»HSG,N  T  H  t  AFG.F  ELEMENT  "kIMP/XX-X"  CONTAINS  ThE 
5t:»“SG,N  CUTPuT  LATA  FROruCED  PY  THE  .IMP.  ThT 
l?:»xi(.tn  "xx-xM  PORTION  CF  THE  ELEMENT  NAME  MUST  BE 
!f tk'lC.N  Change  L  TO  REELECT  THE  APPRCRIATE  POSTURE  ITEk 
IN  :.*'SG , AT,  ce  OR  LLI  ANu  SEQUENCE  NUMBER  OF  THE 

•  tt^st  ,N  RUN  lit.  I  -  1C  1  . 

*t  1  :  k  I  t  E  o  F  . 

12:.PRKPT  Ft.  I N  T  i 
k  3:.F  L,R  82PRINT  . 


Figure  HI. 2. 2 
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Figure  III. 2. 3 
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CHAPTER  3 


UTILITY:  WIMP/TOE-IN 

DESCRIPTION  -  The  purpose  of  the  utility,  WIMP/TOE-IN,  is  to  produce  a 
Table  of  Organization,  Equipment  (TOE)  for  each  type  of  Blue  (force's) 
unit  represented  in  a  stylized  (force's)  posture  array.  Each  TOE  is  unique 
and  prepared  from  the  artillery  vulnerability  categories.  Therefore,  each 
unit's  equipment  level  (quantity)  is  defined  in  terms  of  one  of  the  equip¬ 
ment  types  represented  as  an  artillery  vulnerability  category.  The 
quantity  of  equipment  input  is  the  basis  for  the  assessment  or  loss  compu¬ 
tations  to  follow  in  the  WIMP.  Additionally,  edit  checks  are  made  as  each 
type  unit  code  is  input  from  the  WIMP  unit  file  to  insure  correctness. 
Personnel  losses  are  not  computed  by  the  program;  however,  personnel  are 
treated  as  category  1  throughout  the  WARRAMP  methodology,  and  to 
obviate  these  computations  in  the  programs  to  follow,  category  1  data 
fields  are  set  to  zero  by  this  program.  This  program  produces  one  (output) 
file  during  execution.  It  must  be  run  for  each  stylized  posture,  which,  as  a 
result  produces  a  complete  set  of  TOE's  for  the  force  simulated  across  the 
different  postures.  This  utility  program  is  designed  to  support  the  WARF 
INTERMEDIATE  MATERIEL  PROCESSOR  by  preparing  the  TOE's  for  each 
posture  (attack, defense  intense,  delay,  defense  light). 

STRUCTURE  -  The  features  of  the  WIMP/TOE-IN  utility  program  is 
presented  in  Figure  III. 3.1.  The  relationship  to  this  program  to  the 
WARRAMP  methodology  is  presented  in  Section  II.  This  program  must  be 
run  (executed)  for  each  desired  output  (TOE  by  posture)  file  pictured. 

DATA  BASE  -  The  WIMP/TOE-IN  utility  program  requires  the  following 
system  resident-mass  storage  data  files: 

88.  RAM/MATRIX:  The  input  data  reflecting  the  type  unit  identification 
and  the  authorized  TOE  equipment  level  by  artillery  vulnerability  cate¬ 
gory.  This  data  file  is  produced  by  the  utility  called  RAM/MATRIX. 

82WIMPDATA.UNITXXX:  The  input  data  presenting  the  posture  array 
data  by  unit  as  used  by  the  COSAGE  simulation.  This  is  data  for  one 
posture.  The  "XXX"  portion  of  the  element  name  should  be  edited  out 
during  file  element  generation  from  the  source  file  and  replaced  with  an 
appropriate  "-AT"  (attack),  "-DI"  (Defense  Intense),  "-DE"  (delay),  or  "- 
DL"  (Defense  Light)  to  assist  in  maintaining  a  data  audit  trail. 

RUNSTREAM  -  Figure  III. 3. 2  depicts  the  runstream  or  start  file  to  be 
utilized  to  execute  this  utility.  The  runstream  must  be  prepared  for  exec¬ 
ution  by  editing.  The  file  element  presented  is  intended  to  be  executed  in 
the  demand  mode  (from  a  terminal)  by  entering  an  (3ADD 
CSTART*82XQT. WIMP/TOE-IN.  A  Run  card  and  finish  (@F1ND)  card 
would  be  necessary  to  operate  in  the  batch  environment,  using  demand 
mode  entry  of  the  run  (program).  The  following  functions  are  performed 
by  the  runstream: 
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o  Logical  unit  7  (File  7)  is  temporarily  assigned,  and  in  to  which  the 
FN. RAM/MATRIX  data  for  the  appropriate  study  is  edited  (copied). 


o  Logical  unit  8  (File  8.)  is  temporarily  assigned,  and  into  which  a 
selected  COSAGE  unit  data  file  is  edited  (copied).  This  is  one  of  the 
planned  posture  (array)  sets. 

o  Logical  unit  9  (File  9.)  is  temporarily  assigned  as  the  output  (write)  file 
to  contain  the  results  of  execution  of  this  utility  program. 

o  The  program  is  executed.  One  data  error  condition  will  cause  the 
program  to  terminate:  If  the  number  of  type  units  input  from  the 
RAM/MATRIX  data  file  exceeds  499. 

o  The  contents  of  the  temporary  file  9.  are  edited  (copied  into)  the  file 
element  88.TOE-IN-XX.,  20  lines  of  the  file  element  are  edited 
(printed)  in  the  users  run  (PRINT$)  file  and  a  normal  exit  is  made.  The 
"XX”  portion  of  the  file  element  name  should  be  changed  (edited)  to 
agree  with  the  "UNITXXX"  label  to  maintain  the  data  audit  trail. 

o  The  program  files  assigned  temporarily  to  the  run  are  released  to  the 
system. 

INPUT  -  An  execution  of  the  WIMP/TOE-IN  program  requires  two  input 

data  files.  The  first  data  file  is  the  PF. RAM/MATRIX  data  file  element. 

It  is  produced  by  an  execution  of  the  utility:  RAM/MATRIX  discussed  in 

Chapter  11.  A  sample  input  data  file  is  presented  in  Figure  III. 3.3. 

The  following  is  the  file  format: 


FILE  .RAM/MATRIX 

STORAGE  MEDIUM:  Mass  Storage  Device 

SOURCE:  Output  from  Utility  RAM/MATRIX 

RECORD  FORMAT: 

Position 

Description 

Field  Format 

1 

Blank 

IX 

2  -  3 

Type  unit  code,  first  2  charac¬ 
ters  of  type  unit  code 

A2 

4  -  5 

Subscript  to  the  above  code 

12 

6  -  93 

Integer  quantities  of  equipment 

TOE  levels  by  vulnerability 
group  (22  each) 

22(14) 

The  second  input  data  file  contains  the  unit  data  of  the  stylized  blue  force 
array  for  a  given  posture.  The  source  data  is  the  same  as  that  prepared 
(arrayed  for)  COSAGE.  The  program  expects  a  formatted  data  on  records 
as  shown  below;  if  a  zero  record  or  data  field  is  found,  the  next  record  is 
read.  A  sample  input  data  file  is  in  Figure  III. 3.4. 
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FILE  .UNITXXX 


STORAGE  MEDIUM;  Mass  Storage  Device 
SOURCE:  Created  manually  or  by  SUSF  for  COSAGE 

RECORD  FORMAT: 


3.6 


10 

13 


Position 

Description 

Field  Format 

1  -  6 

Skipped  (Blank) 

6X 

7  -  9 

Unit  Sequence  Number 

13 

-  12 

Skipped  (Blank) 

3X 

-  14 

Type  Unit  Code 

12 

OUTPUT  -  An  execution  of  the  WIMP/TOE-IN  program  produces  one 
output  file  element,  PF.TOE-IN-XX. .  Editing  of  the  runstream  is  needed 
to  replace  the  "xx"  in  the  element  name  and  catalog  the  output  file 
element  according  to  the  posture  for  the  audit  trail.  Sample  output  is 
presented  in  Figure  111.3.5.  The  formated  write  is  all  in  decimal  and  two 
records  are  required  for  each  Type  Unit  (TOE),  with  a  blank  record 
between  each  type  unit.  The  first  value  is  for  personnel  and  is  always 
zero.  There  are  22  values  per  type  unit.  The  type  unit  values  are  sequen¬ 
tial  and  not  reflected  on  the  output. 


FILE:  PF.TOE-IN-XX 
STORAGE  MEDIUM:  Mass  Storage 

RECORD  FORMAT:  (2  RECORDS  required) 


Position 

Description 

Field  Format 

Record  1: 

1 

Skip  (Blank) 

IX 

2  -  8 

Personnel  Quantity 

22(F7.2) 

9  -  96 

Equipment  Quantity 

1X1KF7.2) 

Record  2: 

1  -  89 

Equipment  Quantity 

1XIKF7.2) 

PERFORMANCE 

-  The  execution  of  this  utility 

program  requires  the 

following  resources: 


CORE: 

CPU  TIME: 

CLOCK  TIME: 

DISK  (FILE)  UNITS: 
COMMENTS: 


Less  than  10K 

Less  Than  1  Minute 

Less  Than  5  Minutes 

3  each  with  default  (128  tracks)  space 

The  program  will  terminate  during  the  input  of 

the  .UNITXXX  data  if  the  number  of  unit 

types  exceeds  499. 
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Figure  HI. 3. 1 
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LnCLAS  *  If  If.  !  L  t  *  A*E  :CS  TA-?T*f2X0T  ELEMENT  \  A  Mf  :  U  1  F*  P  /  1  0  £  -  I  »!•  •  *  UN  C  l  *  S  S  I  T  1  E 

i :  >  is  j  &g««sfc*t 

J  :  <  ^  ®  h<»/  /  ■ 

3  :  *  a  s ,  I  7  . 

4  :  -  A  i, .,  ,  A  F  2  «  I  “  n  A  T  A  • 

c  :L  x  i  r 

N  ME  a'rOVL  riE'ifM  "p  am/m  a  TP  I  X  -  1  "  COM  M  NS  InE 
a:.“J>.,N  I0E  LCJtP“t\!  «UthEPI?£C  S«CH  T  r  P£  UMI 
l:,"),,1.  er  BMIILCCY  viilM  =  a  3  IL  I T  r  caUSOCT. 

1  u  •  u  A  j  if  T  ft  • 

1  1  :  #r  J  I  *Pn  A  T  A  .  'j4  I  T>XX  ,  9. 

1*  slMT 

I H ACLVE  £L-:mF.M  "UNTTXXX"  CONTAINS  THT 
UNIT  FATA  F  M  A  POSTJRE’S  M<3AY  AS  USED 
I  i>  IN  (O'A'i.  THE  "XU"  PORTION  CF  THE 

lcs^iOiN  \  Ayr  MUST  ti  E  CHANGED  TO  REFLECT  THE 

APPROPRIATE  POSTURE. 

1  c  :  j A  o  j 1 1  R  • 

1  v : »  *  p  ,  A  p  E  -i  l k>  p  • 

2  ^  x  „  1  'i  *•!-». «|np/TGI.-In 

2  1  ;  -  f  u  y*fbh#Tv/F-I%-XX 
22: LNP  n  I'. 

2  3  :  L  *  S  T 
2  A  :  c  x  I  T 

2a:»“ir>,N  THE  AfGVil  ELEVEN!  "  T  u€  -  I  N  -  X  XM  -ILL  CONTAIN 
2c:jmS,,N  THE  OUTPUT  DATA  P-01JCE3  ?Y  THIS  UTILITY. 

27:culCf\  THE  "XX"  P09TI0N  OF  THE  ELEMENT  NAME  MUST 
2o:«MSG,N  or  ChANCf.  E  TO  REFLECT  T Ml  ADPHOPRIATl 
29;»PSO,N  POSTJPl. 

3c:*7r<tt  7  • 

31  Free  F  . 

32:»Fwll  S. 

33:*FKEE  1 8  . 


Figure  III. 3. 2 
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CHAPTER  4 

UTILITY:  WIMP/LOSS-RATES 


4.1  DESCRIPTION  -  The  purpose  of  this  utility  program  is  to  process  the  out¬ 
put  from  the  WARF  INTERMEDIATE  MATERIEL  PROCESSOR  (WIMP)  and 
computes  the  average  equipment  loss  rates  by  vulnerability  category 
('(Including  personnel),  for  each  combat  posture  modeled.  The  output  is 
manually  input  (bv  system  editor  applicatin)  to  the  CONTROL/TEMP  input 
data  file.  For  a  given  posture  (unit  and  force  data)  multiple  runs  of  the 
WIMP  mav  be  made  to  satisfy  the  required  statistical  confidence  level  for 
a  study.  The  output  from  each  WIMP  run  (execution)  is  merged  by  this 
program.  The  computations  sum  (total)  the  losses  for  each  type  unit  rep¬ 
resented  in  the  array,  across  each  artillery  vulnerability  group  and 
computes  the  average  loss  per  vulnerability  group.  The  average  loss  is 
divided  by  the  total  items  (produced  by  WIMP/TOTAL-CAI)  per  posture  to 
yield  the  loss  rate  and  loss  data  by  posture  for  each  artillery  equipment 
vulnerability  group. 

4.2  STRUCTURE  -  A  schematic  of  the  functions  of  the  WIMP/LOSS-RATES 
utility  program  is  m  Figure  III. 4.1.  A  single  run  (execution)  processes  only 
one  of  the  force  postures  modeled. 

4.3  DATA  RASE  -  The  WIMP/LOSS-RATES  program  requires  the  following 
system  resident-mass  storage  data  files.  These  files  generally  are 
prepared  for  a  given  study  and  are  not  incorporated  into  a  permanent  data 
base  structure.  For  long-term  retention,  they  may  be  individually  copied 
onto  tape  or  archieved.  If  appropriately  cataloged,  they  will  be  retained 
through  the  periodic  system  "secures"  when  all  system  resident  files  are 
copied  onto  tape. 

88.WIMP/XX-N:  An  input  data  file  produced  by  the  WIMP  program. 

Multiple  files  of  this  structure  may  be  used  as  data  samples  containing 
losses  by  each  blue  (force)  unit  ina  given  posture  (array).  When  multiple 
files  are  used,  the  "xx"  must  be  edited  out  of  the  runstream  and  replaced 
by  the  appropriate  posture  symbol  (AT  =  Attack,  DL  =  Defense  Light,  DE 
=  Delay,  DI  _  Defense  Intense).  The  "N"  value  should  be  changed  to 
reflect  the  sequence  number  of  the  (iterative)  run  that  produced  this 
file.  These  techniques  enable  a  user  to  maintain  a  data  audit  trail  for 
data  verification  and  study  report  preparation. 

88. WIMP- XX /TOT AL-CAT :  An  input  data  file  produced  by  the  utility 
program  WIMP/TOTAL-CAT.  A  single  copy  of  this  file  is  required  per 
posture  (force  array)  modeled.  The  "xx"  portion  of  the  file  element  name 
must  be  changed  (edited)  to  reflect  the  appropriate  posture  symbol  as  dis¬ 
cussed  above,  for  the  purposes  of  auditing. 

RUN  DATA:  The  program  execution  runstream  requires  two  data  values, 
the  total  number  of  blue  units  in  the  posture  (force)  array,  and  the  number 
of  copies  of  the  WIMP/XX-N  file  to  be  executed. 
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RUNSTREAM  -  The  program  execution  runstream  is  depicted  in  Figure 
III. 4. 2.  The  file  element  is  designed  to  be  executed  in  the  demand  mode. 
Once  the  file  is  edited  at  the  terminal  to  replace  the  "xx"  and  "N"  value 
and  introduce  the  unit  quantity  and  "N"  on  line  39,  it  may  be  executed  by 
entering  the  (9ADD  command  followed  by  options  and  the  file  name  and 
element  name.  The  execution  runstream  is  within  a  break-pointed  file  and 
that  file  (82PRINT.,  in  this  case)  would  need  to  by  (dSYM'd  for  hard  (print) 
copy.  The  following  actions  re  performed  in  the  runstream: 

o  The  breakpoint  file  (XXPRINT.)  is  established. 

o  The  cataloged  file  containing  the  data  input/output  files  is  designed  as 
88.  by  the  (dUSE  command. 

o  The  temporary  file  7.  is  assigned  and  through  the  fdDATA,!  command 
the  data  files  for  the  sample  results  from  the  wlMP  for  a  posture  are 
added  (copied)  to  it. 

o  The  temporary  file  9.  is  assigned  and  through  the  (9DATA,I  command, 
the  TOTAL-CAT  data  is  input  (copied)  to  the  file. 

o  The  temporary  files  (logical)  8.,  10.,  and  11.  are  assigned  to  support 
the  program  execution. 

o  The  program  execution  is  started  (@XQT)  followed  by  the  additin  of 
two  data  values  as  shown  on  record  (line)  39.  The  first  integer  value  is 
the  total  number  of  blue  nits  in  the  force  modeled  (arrayed)  and  the 
integer  number  of  the  quantity  of  loss  samples  (example  is  10)  input 
from  the  WIMP. 

o  The  input  file  element  .WIMP-XX/TOTAL-CAT  is  printed  in  its  en¬ 
tirety  via  the  @ED  command. 

o  The  output  from  the  execution  is  edited  (copied)  into  the  file  element 
.WIMP/LOSS-XX  and  the  contents  printed  in  its  entirety  via  the  (3ED 
command. 

o  The  file  is  break  pointed  (XXPRINT.)  and  the  editor  entered  for  the 
terminal  operator  to  review  (edit)  the  file. 

INPUT  -  An  execution  of  the  WIMP/LOSS-RATES  utility  program  requires 
two  types  of  input  data  files  plus  runstream  data.  The  first  data  file  is 
the  .W1MP/XX-N  element.  At  least  1  copy  of  the  file  is  required;  as  many 
as  required  to  satisfy  the  study  requirements  will  be  used.  The  sample 
output  is  shown  in  Figure  III. 4. 3.  The  file  format  is  as  follows: 


FILE:  .WIMP/XX-N 

STORAGE  MEDIUM:  Mass  Storage  Device 
SOURCE:  Output  from  WIMP  program 

RECORD  FORMAT:  Two  (2)  records  are  required  for  each  type  unit 
modeled  inthe  force  array,  separated  by  a  blank 
line.  The  two  records  contain  the  one  decimal 
entry  for  each  artillery  vulnerability  category 
modeled  (22  is  current  methodology). 

The  second  file  required  for  input  is  the  file  element  .WIMP-XX/TOTAL- 
CAT.  The  data  sample  is  depicted  in  Figure  III. 4. 4.  The  file  format  is  as 
follows: 

FILE:  .WIMP/TOTAL-CAT 

STORAGE  MEDIUM:  Mass  Storage  Device 

SOURCE:  Output  from  the  utility  .WIMP/TOTAL-CAT 

RECORD  FORMAT:  The  file  contains  23  records,  one  for  personnel 
plus  one  for  each  artillery  vulnerability  category  (22  each). 

Position  Description  Field  Format 

1  Blank  IX 

2-11  Total  items  110 

.6  OUTPUT  -  An  execution  of  the  WIMP/LOSS-RATES  utility  program 
produces  two  types  of  output  data  and  files.  One  execution  of  the 
program  is  required  for  each  posture  modeled  (arrayed).  One  output  is  the 
computed  losses  of  equipment  in  a  vulnerability  group,  the  second  is  the 
loss  rate,  a  percent  based  upon  the  total  items  available  in  the  force  array 
(posture).  The  first  file  presented  is  the  loss  file  depicted  in  Figure 
III. 4. 5.  The  file  format  is  as  follows: 

FILE:  .WIMP/LOSS-XX 

STORAGE  MEDIUM:  Mass  Storage  Device 

SOURCE;  Output  from  the  utility  WIMP/LOSS-RATES 

RECORD  FORMAT:  The  file  contains  23  records;  one  for  personnel 
plus  one  for  each  artillery  vulnerability  category  modeled  (22  each). 


Position 

Description 

Field  Format 

1 

Blank 

IX 

-  11 

The  equipment  losses 

F10.2 
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The  second  file,  .WIMP/RATES-XX  is  depicted  in  Figure  III.^.6.  The 
format  is  as  follows: 


FILE:  .WIMP/RATES-XX 

STORAGE  MEDIUM:  Mass  Storage  Device 

SOURCE:  Output  from  the  utility  WIMP/LOSS-RATES 

RECORD  FORMAT:  The  file  element  contains  23  records;  one  for  per¬ 
sonnel  plus  one  for  each  vulnerability  category  modeled  (22  each). 

Position  Description  Field  Format 

1  -  7  The  decimal  loss  percent  F7.5 

k.7  PERFORM ANCE  -  The  execution  of  this  utility  program  requires  the 
following  resources: 

CORE:  LESS  THAN  10K 

CPU  TIME:  LESS  THAN  1  MINUTE 

CLOCK  TIME:  LESS  THAN  5  MINUTES 

DISK  (FILE)  UNITS:  5  each  with  default  (128  tracks)  space 

COMMENTS:  The  Start  file  will  require  additional  cards 

(records)  to  be  operated  in  a  batch  en¬ 
vironment. 
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wimp/loss-rates  structure 


Figure  III. 4. 1 
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CHAPTER  5 


UTILITY:  LEA/TAPE 

5.1  DESCRIPTION  -  The  purpose  of  this  utility  is  to  process  a  magnetic  tape 
supplied  by  the  Logistics  Evaluation  Agency  (LEA)  which  describes  the 
Major  Items  of  Equipment  (MIE)  being  used  in  the  current  study  as  to  the 
quantity  and  density  profiles  of  each  item  by  its  Line  Code  (LINCODE). 
The  utility  will  split  the  quantity  and  density  profiles  for  each  LINCODE 
and  write  them  into  separate  sequential  files;  one  for  quantity  profile  and 
one  for  density  profile.  These  files  will  be  used  as  input  to  a  following 
utility,  ITMID/TEMP. 

5.2  STRUCTURE  -  Figure  111.5.1  depicts  the  general  flow  chart  or  structure  for 
the  utility. 

5.3  DATA  EASE-  The  LEA/TAPE  utility  uses  the  LEA  tape  as  its  only  source  of 
data  and  produces  the  two  sequential  files,  Density,  and  Quantity  Profiles. 
These  files  are  discussed  in  more  detail  in  section  5.5.  The  LEA  tape  file  is 
supplied  by  the  Logistics  Evaluation  Agency  (LEA)  on  a  magnetic  tape  with 
the  following  characteristics: 

-  Tracks  =  9 

-  Blocking  factor  -  128 

-  Recording  Density  -  800  API 

The  two  output  files  are  written  and  stored  on  standard  system  mass 
storage  devices. 

5.4  R UNSTREAM  -  Figure  III. 5.2  depicts  the  runstream  which  is  used  to  exe¬ 
cute  and  control  this  utility.  The  utility  performs  the  following  functions: 

o  Uses  Logical  Unit  7,  the  9  Track  LEA  Tape  is  copied  into  the  system. 

o  Logical  Units  8  and  9  are  allocated  for  output. 

o  IJtilitv  executed. 

o  Text  editor  activated  and  the  newly  created  QUANTITY/PROFILE  and 
DENSITY/PROFILE  files  are  copied  into  their  permanent  storage  loca¬ 
tions  under  the  general  file  "SECRET  *82WARF88.  While  doing  so,  the 
first  10  records  of  each  files  is  printed  for  review. 

o  Finally,  all  units  allocated  for  the  utility  are  released. 

5.5  INPUT  -  The  LEA/TAPE,  provided  bv  the  Logistics  Evaluation  Agency 
(LEA),  is  the  only  input  required  by  this  utility.  The  format  of  the  tape  is 
depicted  in  Figure  III. 5. 3. 

This  tape  is  provided  to  CAA  on  a  studv  requirement  basis. 
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The  tape  is  referred  to  internally  within  LEA  as  WARF  P-Study  L1NCODE 
DENSITY/QUANTITY,  PROFILES  TAPE. 

5.6  OUTPUT  -  The  utility  produces  two  mass  storage  file  ouptuts.  One  file  is 
the  DENSITY/PROFILES  file.  This  file  describes  for  each  Major  Item  of 
Equipment  (MIE),  identified  by  its  LINCODE,  its  density  within  each  of  the 
five  combat  zones,  for  each  of  the  seven  time  periods  being  played. 
Density  as  described  here  is  defined  as  the  percentage  of  the  available  item 
of  equipment  which  can  be  found  in  a  combat  zone  during  a  specific  time 
period.  In  all  cases,  the  percentages  for  an  item  during  a  time  period 
should  sum  to  100%.  Thus,  by  multiplying  the  quantity  of  the  item  avail¬ 
able  for  a  given  time  period  as  described  in  the  OUANTITY/PROFILES  file, 
by  the  density  percentage  for  a  combat  zone  for  that  time  period,  the 
actual  number  of  these  items  in  this  zone  can  be  determined. 

FILE:  OUANTITY/PROFILES 

STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  LEA/TAPE  UTILITY 

RECORD  UTILITY: 


Columns  Description  Format 


1  Flank  IX 

2-7  Line  Code  A6 

8-17  Rlanks  10X 

18  -  80  Quantity  Profile  (91) 


for  Periods  1  -  7 

The  following  presents  a  file  layout  for  the  DENSITY/PROFILES  file  as 
Figure  111.5.**  presents  an  example  of  the  data  as  it  is  found  in  the  file.  As 
can  be  seen  from  the  file  layout  and  the  example,  there  will  be  five  records 
for  each  MIE  in  the  file;  one  record  for  each  combat  zone  of  the  battle 
area.  Further,  within  each  record  there  will  be  eight  occurrences  of  the 
actual  density  percentage  of  this  item  found  within  the  combat  zone;  one 
for  D-DAY  and  each  of  the  seven  time  periods  of  the  exercise. 

PILE:  DENSITY/PROFILES 


STORAGE  MEDIUM: 

Mass  Storage 

SOURCE:  UTILITY 

LEA/TAPE 

RECORD  FORMAT: 

Position 

Description 

Format 

1 

Blank 

IX 

2  -  7 

Line  Code 

A6 

8  -  18 

Rlanks 

1  IX 

19  -  53 

Density  Profiles  for  this  Line 

Item  for  Periods  1-7 

7  (F  5.1) 

68 


ran  hr  seen  from  the  record  layout,  there  will  be  one  record  for  each 
MIE  and  eight  occurrences  of  its  quantity;  D-DAY  and  one  for  each  time 
period.  Figure  III. 5. 5  presents  an  example  of  the  data  that  can  be  found  in 
the  file. 

PERFORM  ANTE  -  This  utility  requires  the  following  resources  be  allocated 
in  order  to  run: 


CORE  REQUIREMENTS:  LESS  THAN  10K 


CPU. TIME:  1  MIN 

CLOCK  TIME:  5  MIN 

COMMENTS:  NONE 

Error  Checks:  None 
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UTILITY-ITM1  D/TEMP 

6.1  DESCRIPTION:  The  purpose  of  this  utility  is  to  merge  together  data 
from  the  QUANTITY/PROFILES  file  and  the  DENSITY/PROFILES  file 
created  by  the  previous  utility  LEA/TAPE  with  the  L1NCODE/LIST  file. 
The  LINCODE/LIST  file  is  created  manually  in  the  LINCODE/LIST 
element  of  the  WARF  program  file  of  the  current  study,  using  as  its 
source,  data  provided  by  the  study's  sponsor. 

The  utility  reads  in  the  LINCODE  and  the  nomenclature  from  the 
LINCODE/LIST  file  and  the  corresponding  7-period  quantities  from  the 
QUANTITY/PROFILE  file  and  the  first  7  time  period  density  figures 
from  the  DENSITY/PROFILE  file  and  immediately  writes  out  this  data 
onto  the  ITMID/TEMP  file. 

The  utility  does  not  check  to  ensure  that  the  LINCODE  on  the 
LINCODE/LIST  corresponds  to  the  LINCODE  on  the 
OUANTITY/PROF1LE  and  DENSITY/PROFILE  files.  Therefore,  it 
assumes  that  all  files  are  sorted  on  LINCODE  and  all  files  will  have 
matching  LINCODES. 

6.2  STRUCTURE  -  The  overall  structure  of  this  utility  is  displayed  in  Figure 
JII.6.1. 

6.3  DATA  BASE  -  This  utility  uses  a  data  base  of  three  data  files  in  order  to 
produce  the  ITMID/TEMP  file.  The  first  two  files,  i.e., 
DENSITY/PROFILES  and  QUANTITY/PROFILES,  are  stored  on  mass 
storage  devices  and  were  produced  by  the  previous  utility,  LEA/TAPE. 
The  third  file  is  manually  produced  either  in  punch  card  form  or  through 
the  online  system  editor  facility  using  the  hard  copy  listing  of  list  of 
LINCODES  and  their  nomenclature  being  played  in  this  study  as  supplied 
by  the  study's  sponsor.  In  either  case,  by  the  time  the  file  is  read  into 
the  utility  it  will  reside  on  mass  storage. 

The  utility  will  produce  one  file  as  its  output  data  base,  the  ITMID/TEMP 
file. 

6.4  RUNSTREAM  -  The  runstream  for  this  utility  can  be  found  in  file 
CSTART*82XQT  under  element  name,  ITMID/TEMP.  Figure  III. 6. 2 
depicts  the  runstream.  The  runstream  ^complishes  the  following  func- 
-tions: 

o  Requires  the  user  provide  the  appropriate  password  to  gain  access  to 
the  file  SEC.RET*82W ARFP88  where  the  data  files  and  program  files 
are  stored. 

o  Assigns  the  DENSITY/PROFILES,  the  QUANTITY/PROFILES  and  the 
LINCODE/LIST  data  fiies  to  logical  units  9,  8,  7,  respectively. 
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o  Executes  the  utility. 


o  Copies  the  resulting  data  file  from  logical  unit  3  to  the  permanent 
file  1TM1D/TEMP  and  writing  out  the  first  18  lines  of  the  data  file  for 
user  review. 

o  Releases  units  3,  7,  8,  9  and  88  that  were  allocated  for  the  utility. 

INPUT  -  The  utility  will  use  these  files  stored  on  mass  storage  devices  as 
input;  DENSITY/PROFILE,  QUANTITY/PROFILE  and  the  LINCODE/LIST 
files.  Figure  111.6.3  gives  the  file  layout  and  examples  of  the  data  for  the 
DENSITY/PROFILES  file.  Figure  111.6.4  does  the  same  for  the 
QUANTITY/PROFILES  file  and  Figure  III. 6. 5  for  the  LINCODE/LIST 
file. 

FILE:  DENSITY/PROFILES 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  UTILITY  LEA/TAPE 


RECORD  FORMAT: 


Position 

Description 

Format 

l 

Blank 

IX 

2  -  7 

Line  Code 

A6 

8  -  18 

Blanks 

I1X 

19  -  53 

Density  Profiles  for  this 
line  Item  for  Periods  I  -  7 

(F5.1) 

FILE:  QUANTITY/PROFILES 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  LEA/TAPE  UTILITY 

RECORD  FORMAT: 

Columns 

Description 

Format 

1 

Blank 

IX 

2-7  * 

Line  Code 

A6 

8-17 

Blanks 

19X 

18  -  80 

Quantity  Profile  for  Periods  l  -  7 

709) 

FILE:  LINCODE/LIST 
STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  Study  Sponsor.  Manually  entered  using  list  of  LINCODES 

supplieo  by  sponsor. 

RECORD  FORMAT: 


Positions 

Description 

Format 

1 

Blank 

IX 

2  -  7 

Line  Code  obtained  from  WARF 
data  file 

A6 

8  -  9 

Blanks 

2X 

10  -  39 

Nomenclature  (30  character  name 
of  item  of  Equipment  obtained 
from  WARF  data 

5A6 

OUTPUT  -  This  utility  produces  one  output  file;  the  ITMID/TEMP  file  on 
mass  storage.  This  file  is  a  multi-record  file.  The  header  or  identifica¬ 
tion  record  identifies  the  item  being  described  by  its  LINCODE  and 
provides  its  nomenclature.  The  second  record  provides  seven  quantities 
occurrences  for  this  item;  one  for  each  of  the  time  periods  in  the  exer¬ 
cise.  The  last  record  type  will  occur  five  times;  once  for  each  of  the 
combat  zones  within  the  battlefield.  Within  each  of  these  five  records 
there  will  be  seven  occurences  of  the  density  distribution  for  this  item 
within  the  particular  combat  zone  for  each  of  the  seven  time  periods  in 
the  exercise.  As  in  the  DENSITY/PROFILE  file  which  was  its  source, 
these  densities  within  zones  are  percentages  of  the  total  equipment  avail¬ 
able  for  distribution  during  a  time  period.  Therefore,  the  sumation  over 
each  of  the  five  combat  zones  for  each  time  period  should  equal  100%. 

The  following  presents  a  record  layout  for  the  ITMID/TEMP  file.  Figure 
III. 6.6  gives  an  example  of  the  data  as  it  can  be  found  in  the  file. 

FILE:  ITMID/TEMP 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  UTILITY  ITMID/TEMP 

RECORD  FORMAT: 

Position  Description  Format 

1  Blank  IX 

2-7  Lincode  A6 
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Blank 


IX 


9-39  Nomenclature  5(A6) 

1  -  49  Quantity  totals  for  this  time  7(17) 

Periods  1  -  7 

1  -  35  Density  Profile  Percentage  for  5(F5.2) 

this  item  for  Time  Period  1 
for  Zone  1  -  5 

1  -  35  Density  Profile  Percentage  for  5(F5.2) 

this  item  for  Time  Period  2 
for  Zone  1  -  5 

1  -  35  Density  Profile  Percentage  for  5(F5.2) 

this  item  for  Time  Period  3 
for  Zone  1  -  5 

1  -  35  Density  Profile  Percentage  for  5(F5.2) 

this  item  for  Time  Period  4 
for  Zone  1  -  5 

1  -  35  Density  Profile  Percentage  for  5(F5.2) 

this  item  for  Time  Period  5 
for  Zone  1  -  5 

1  -  35  Density  Profile  Percentage  for  5(F5.2) 

this  item  for  Time  Period  6 
for  Zone  1  -  5 

1  -  35  Density  Profile  Percentage  for  5(F5.2) 

this  item  for  Time  Period  7 
for  Zone  1  -  5 


PERFORMANCE  -  The  program  resource  requirements  are  as  follows: 


o 

CORE: 

20K  or  less 

0 

CPU  TIME: 

5  min  or  less 

o 

CLOCK  TIME: 

1 0  min  or  less 

o 

DISK  UNITS: 

4  each,  space  as  assigned  in 
runstream 

o 

COMMENTS: 

Debugging  of  data  execution 
errors  is  accomplished  by  visual 

inspection 
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CHAPTER  7 

UTILITY  -  ITMID/REC-A 

7.1  DESCRIPTION:  The  purpose  of  this  program  is  to  merge  data  from  the  first 
produced  ITMID/TEMP  element  with  data  from  the  aged  ITMID/FINAL 
element  which  was  produced  and  used  in  the  previous  study.  The  element 
should  still  be  cataloged  under  the  previous  study's  file.  The  result  of  this 
merging  will  be  the  ITMID/FINAL  element  of  the  current  study. 

The  ITMID/FINAL  element  is  composed  of  3  record  types  and  there  will  be 
seven  occurrences  of  this  record  for  each  occurrence  of  the  Master  Record: 

o  The  first  record  type  is  the  Master  Record.  It  contains  information 
which  describes  the  line  item  as  a  whole  such  as  its  name,  vulnerability 
class,  and  supply  levels. 

o  The  second  record  type  denotes  the  quantity  of  this  item  that  will  be 
available  for  each  of  the  seven  time  periods  being  played  in  the  study. 

o  The  third  record  type  describes  density  profile  of  this  item  in  each  of 
five  zones  or  areas  of  the  battlefield. 

This  current  program  concentrates  on  the  Master  Record.  To  the  new 
ITMID/FINAL  element  the  program  will  copy  all  the  data  of  the  new 
ITMID/TEMP  element  and  only  columns  40-54  of  the  previous  study's 
ITMID/FINAL  element.  If  a  new  ITMID/TEMP  Line  Item  cannot  match  an 
existing  line  item  in  the  previous  ITMID/FINAL,  columns  40-54  are  blank  in 
the  new  ITMID/FINAL.  The  line  item  is  written  out  to  another  element 
"MISSED/ITMID-CODES".  WARF  analysts  using  this,  can  then  identify  those 
items  which  need  attention  on  the  new  ITMID/FINAL  element  and  manually 
add  in  the  required  data. 

If  line  items  on  the  previous  ITMID/FINAL  have  no  corresponding  items  on 
the  ITMID/TEMP,  no  records  will  be  copied. 

The  program  works  using  the  following  assumptions: 

All  elements  are  sorted  in  ascending  order  using  LINCODE. 

For  each  Master  Record  there  will  be  one  corresponding  QUANTITY  Record 
and  7  corresponding  DENSITY/PROFILE  Records. 

7.2  STRUCTURE  -  Figure  IH.7.1  shows  the  overall  structure  of  this  utility. 

7.3  DATA  BASE  -  This  utility  uses  a  data  base  consisting  of  four  data  files;  it 
creates  two  as  input  and  two  as  output.  As  input  the  utility  uses  the 
ITMID/TEMP  file  created  in  the  previous  utility  and  ITMID/FINAL  file  which 
ws  created  during  the  previous  running  this  utility  for  a  previous  study.  As 
output  the  utility  creates  two  mass  storage  files.  The  first  output  file  is  the 
ITMID/FINAL  file  for  this  current  study.  The  other  file  produced;  also 


85 


created  on  a  mass  storage  device,  is  the  MISSED/ITMID-CODES.  This  file 
details  to  the  study's  managers  those  items  which  are  being  played  in  the 
current  study  which  were  not  played  in  the  previous  study. 

7.4  RUNSTREAM  -  Figure  III.7.2  shows  the  runstream  which  controls  the 
execution  of  this  utility.  The  utility  performs  the  following  functions. 

o  Assigns  the  file  SECRET*82WARFP88  to  logical  unit  88  and 
SECRET#82WARF86R  to  logical  unit  86  and  requires  the  user  to  provide 
the  password  for  each  file  in  order  to  gain  access  to  the  file. 

o  Copies  the  contents  of  the  previous  studies  ITMID/FINAL  file  to  the 
logical  unit  7  for  processing. 

o  Copies  the  contents  of  the  ITMID/TEMP  file  created  by  the  just 
completed  ITMID/TEMP  utility  to  logical  unit  8  for  processing. 

o  Assigns  logical  units  2,  and  3  to  gather  the  outputs  from  the  utility. 

o  Executes  the  utility. 

o  Copies  the  contents  of  logical  unit  3  to  the  new  ITMID/FINAL  file  and 
prints  out  18  lines  of  the  file  contents  for  verification. 

o  Copies  the  contents  of  logical  unit  2  to  the  MISSED/ITMID-CODES  file 
and  prints  out  10  lines  for  verification. 

o  Releases  all  logical  units  used  by  the  utility. 

7.5  INPUT  -  The  utility  has  two  input  files.  One  file  is  the  ITMID/TEMP  file 
that  was  produced  by  the  previous  utility  ITMID/TEMP.  The  other  file  is  the 
ITMID/FINAL  file  which  was  produced  during  the  last  study.  This  file  should 
be  cataloged  as  an  element  imder  the  previous  study's  name. 

Figures  III.7.3  presents  the  record  layouts  and  an  example  of  data  within  the 
ITMID/TEMP  file.  Figures  II1.7.4  demonstrates  the  same  for  the 
ITMID/FINAL  file  which  could  be  from  the  previous  study. 

FILE;  ITMID/FINAL 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  UTILITY  -  ITMID/RECA 

RECORD  FORMAT: 
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Position 


Format 


*«#■'* . 


Description 


1 

Blank 

IX 

2-7 

Line  item  number  (LIN 

A6 

8 

Blank 

IX 

9  -  38 

Alphanumeric  nomenclature 

5(A6) 

39 

Blank 

IX 

-3* 

1 

o 

•3- 

Type  equipment  code  for  losses 
from  theater  model 

12 

42  -  43 

Vulnerability  class  for  losses 
from  artillery  model 

12 

44  -  45 

Classification  for  Historical  Data 

12 

•P* 

<7\ 

1 

-P* 

00 

In-theater  depot  stockage  (number 
of  days  supply) 

13 

-P* 

SO 

l 

o 

Fraction  of  intertheater  shipment 
which  is  by  air 

F2.2 

51  -  52 

=  1  if  actual  equipment  density  is 
to  be  read  and  used 

12 

=  0  if  density  is  to  be  estimated 
from  the  number  of  divisions  in 
theater 

87 


53  -  54 


=  1  if  combat  losses  are  from  the  t2 

theater  simulation 

=  2  if  combat  losses  are  from  artil¬ 
lery  models 

=  3  if  all  losses  are  from  history 
55  -  58  Sequence  number  14 


1  -  49  Quantities  of  this  line  item  for  7(17) 

the  seven  time  periods  of  the 
exercise,  obtained  from  the  new 
ITMID/TEMP  file. 

1  -  35  Density  Profiles  for  Time  Period  N  (5F5.2) 

for  this  line  item  in  each  of  the 
five  zones  or  areas  being  played  in 
this  exercise.  These  density 
profiles  are  obtained  from  the  new 
ITMID/TEMP  file.  There  must  be  seven 
occurrences  of  this  record;  one  for 
each  time  period  being  played. 


7.6  OUTPUT  -  This  utility  produces  one  primary  element  as  output  and  are 
secondary.  The  primary  product  is  the  ITMID/FINAL  file.  It  details  each 
item  of  equipment  being  played  in  the  scenario,  providing  quantity  and 
density  statistics.  The  second  product  of  this  utility  is  the  MISSED/1TMID- 
CODES  elements.  Entries  in  this  element  identify  those  items  being  played 
in  this  exercise  which  were  not  present  in  the  previous  study.  As  a  result 
columns  40-54  of  the  ITMID/FINAL  element  will  be  blank.  In  order  for  the 
study  to  be  completed  these  fields  must  be  normally  edited  and  correct  data 
supplied. 


Figures  III.7.4  presents  the  record  layouts  and  examples  of  data  for  the 
ITMID/FINAL  file.  Figure  III.7.5  presents  an  example  of  MISSED/ITMID- 
CODES. 


FILE:  MISSED/IT  MID-CODES 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  UTILITY-ITMID/REC-A 

RECORD  FORMAT: 


Position 

Description 

Format 

I 

Blank 

IX 

2  -  7 

Line  item  number  (LIN) 

A6 

8 

Blank 

IX 

9  -  38 

Alphanumeric  nomenclature 

5A6 

7.7  PERFORMANCE  -  In  order  to  execute  the  following  resources  are  required: 

o  CORE  REQUIREMENTS  10K  OR  LESS 

o  CPU  TIME  10  MIN  OR  LESS 

o  CLOCK  TIME  15  MIN  OR  LESS 

o  COMMENTS  NONE 
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UNCLASSIFIED  •••F  ILE  NAME  ICST  ART*3E  XGT  ELEMENT  NAME  I IT  MI C/REC-A* • • UNCL AS SIFIED 

118USE  88..SECRET.82WARFP88. 

218ASC.A  38/  / 

318USE  86  • .  SE  CR  £T  •  8  2W  AR  F  8  6R  • 

4  18  AS  G.  A  86/  / 

518ASS.T  7..///500 

6  18ED  86  .1 TM  10  /F  IN  At  *7  • 

7  !E  XIT 

SI3MSG.N  THE  ABOVE  ELEMENT  FILE  "  ITM ID/TIL  E*  IS  THE  FINAL  ITMID 
S1SMSS.N  USEC  IN  THE  PREVIOUS  STUDY  <IN  THIS  EXAMPLE  P86).  THIS 
1018MSG.N  FILE  SERVES  AS  INPUT  TO  THIS  UTILITY  AND  PROVIDES  THE 
11I8MSG.N  THE  PREVIOUSLY  USED  RECORD  *A*  DATA  FOP  EACH  LIN  CODE. 

12  18  AS  S»  I  8. 

13:8ED  88.ITMID/TFMP.8. 

i<*  :exit 

15  13  MS  G.  N  THE  ABOVE  ELEMENT  FILE  ■ITMIO/TEMP*  IS  THE  OUTPUT  OF 

16  18MS  G.  N  UTILITY  ■  82  XQ  T.  IT  MIO/  TEMP  *  AND  THE  CURRENT  STUDY'S  ITMID  DATA. 
1713MSG.N  THIS  DATA  IS  INPUT  TO  THIS  UTILITY. 

1818ASG.T  3..///500 
1B18ASG.T  2..///500 
20  18  ASS.  A  82X0  T. 

21 18  XG  T  82XQT.  ITMIO/REC-A 
2218E0  3.  .88.  ITHID/FINAL 

23  IP  18 

24  1L  AS  T 

25  IE  XIT 

26I8MSG.N  THE  ABOVE  ELEMFNT  FILE  *  I TMID/FIN  AL”  IS  THE  OUTPUT  OF  THIS 
27  ISMS  G.  N  UTILITY  AND  EXCEPT  FOR  MANUAL  EDITS  THAT  MAY  BE  REQUIRED 
28 18 MS  3.  N  DUE  TO  CHANGES  IN  LIN  CODES  WILL  BE  THE  FINAL  ITMID  FILE 
2BI8MSG.N  FOR  INPUT  TO  ELCON. 

30  1 8 ED  2.  *38.  MI  SSED/I  TMID-C  ODES 

31  IP  10 
32ILAST 
33  IE  XIT 

3418MSG.N  THE  ABOVE  ELEMENT  FILE  "MISSEO/ITMID-COOES*  PROVIDES  A 
3S18MSG.N  LIST  OF  THOSE  LIN  COOES  FOR  WHICH  A  MATCH  COULD  NOT  BE 
I6I8MS3.N  FOUND  BETWEEN  THE  PREVIOUS  AND  CURRENT  STUDY. 

37  1 8 FREE  2. 

38  13  FREE  3. 

39I8FREE  7. 

40  18 FREE  8. 

41 18 FR  EE  86. 

42  13 FR EE  88. 


Figure  IIK7.2 
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UNCLASSI  FI EO  •••EXAMPLE 

OF 

THE 

i : 

AO  3198 

AX 

VEH  M2 18  SM  EQ 

2 : 

54 

84 

44 

3: 

.00 

.00 

.00 

.80 

.  20 

a  : 

.00 

.00 

.00 

.80 

.20 

5 : 

.00 

.00 

.00 

.80 

.20 

8 : 

.00 

.OU 

.00 

.80 

.20 

7: 

.00 

.00 

.00 

.80 

.20 

a : 

.00 

.00 

.00 

.80 

.20 

9: 

.00 

.00 

.00 

.75 

.25 

10 : 

A14752 

AOAP  TEST 

CAMERA  1 

n : 

10 

16 

16 

12: 

.00 

.00 

.20 

.80 

.00 

13: 

.00 

.00 

.20 

.90 

.00 

ia: 

.00 

.00 

.20 

.80 

.00 

is: 

.00 

.00 

.  15 

.85 

.00 

16: 

.OU 

.00 

.15 

.85 

.00 

17: 

.00 

.00 

.35 

.8  5 

.00 

ia: 

.00 

.00 

.35 

.85 

.00 

ss 


78 


88 


88 


17 


17 


17 


17 


19: 


20: 

6615 

6699 

88  20 

81 

21: 

.25 

.25 

.50 

.00 

.00 

22: 

.25 

.25 

.  50 

.00 

.00 

23: 

.25 

•  25 

.50 

.00 

.00 

24 : 

.25 

.25 

.50 

.00 

.00 

25 : 

.25 

.25 

.50 

.00 

.00 

26: 

.25 

.25 

.SO 

.00 

.00 

27: 

.25 

.25 

.50 

.00 

.00 

8823  8823  8978 


28: 

29: 


*23770  AIR  C  OND  FL/KNDW  80008 


30 : 

.00 

.00 

.00 

.00 

.no 

31 : 

.00 

.00 

.00 

.00 

.00 

32: 

.00 

.00 

.00 

.□u 

.00 

33: 

.00 

.00 

.00 

.no 

.no 

34; 

.01) 

.00 

.00 

.00 

.00 

35: 

.00 

.00 

.00 

.OU 

.00 

36: 

.00 

.00 

.00 

.00 

.00 

37: 

A2  38  28 

AIR 

COMO 

F/WA 

9000 

39: 

8  89 

99  3 

9  98 

9< 

39: 

.00 

.00 

.25 

.25 

.50 

40: 

.00 

.00 

.  25 

.25 

.50 

41 : 

.00 

.00 

.25 

.25 

.50 

42 : 

.00 

.00 

.25 

.25 

.50 

43: 

.00 

.00 

.25 

.25 

.50 

44 : 

.OU 

.00 

.25 

.25 

.50 

45 : 

.00 

.00 

.25 

.25 

.50 

46 : 

A24044 

AIR 

CONO 

16000 

BTU 

998 


998 


998 


»7: 


53 


53 


S3 


55 


55 


55 


55 


48  : 

.00 

.00 

.00 

.50 

.50 

49 : 

.00 

.00 

.00 

.50 

.50 

50: 

.00 

.00 

.00 

.50 

.50 

51 : 

.00 

.00 

.uo 

.50 

.50 

52: 

.00 

.00 

.00 

.30 

.70 

53: 

.OU 

.00 

.00 

.30 

.70 

54  : 

.00 

.00 

.00 

.30 

.70 

55 : 

*24318 

AIR 

CONO 

18  000 

R7U 

56 : 

15 

25 

42 

1 

57: 

.00 

.00 

.25 

.75 

.00 

57 


63 


83 


97 


Figure  III.7.3 
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UNCLASSIFIEO»“EXAMPLr  Of  THE  OUTPUT  OF  UTILITY  I THIO/REC-X** ‘UNCLASSIFIED 


i: 

AO  319a 

AK 

VEH  N218  GH  EQ  P1A 

0  522 

30  0 

1 

2 

?: 

54 

64 

44 

58 

78 

88 

88 

3: 

.00 

.00 

.00 

.80 

.20 

4 : 

.00 

.00 

.00 

.90 

.20 

5 : 

.00 

.00 

.00 

.80 

.20 

g: 

.00 

.00 

.00 

.80 

.20 

7; 

.00 

.00 

.00 

.80 

.20 

a : 

.00 

.00 

.00 

.80 

.20 

9: 

.00 

.00 

.00 

.75 

.25 

10: 

A147S2 

ADAP  TEST 

CAMERA  LM178 

01636 

30  0 

1 

2 

11: 

10 

16 

16 

17 

17 

17 

17 

1?: 

.00 

.00 

.20 

.80 

.00 

13: 

.00 

.00 

.20 

.80 

.00 

14 : 

.00 

.00 

.20 

.80 

.00 

is: 

.00 

.00 

.  15 

.85 

.00 

16 : 

.00 

.00 

.15 

.85 

.00 

xt: 

.00 

.00 

.  35 

.65 

.00 

is: 

.00 

.00 

.  35 

.65 

.00 

is : 

A2  24  96 

AIM  IN 0  CIRCLE 

M2  W/E 

01636 

30  0 

1 

2 

20: 

6615 

6699 

3320 

8823 

8823 

8823  8978 

21 : 

.25 

.25 

.50 

.00 

.00 

22: 

.25 

.25 

.50 

.00 

.OU 

23: 

.25 

.25 

.  50 

.00 

.00 

24: 

.25 

.25 

.50 

.00 

.00 

25 : 

.25 

.25 

.50 

.00 

.00 

26 : 

.25 

.25 

.50 

.00 

.00 

27 : 

.25 

.25 

.50 

.00 

.00 

28 : 

A2  37  70 

AIR 

CONO 

FL/WNOW  6000  8 

01833 

30  0 

1 

2 

29: 

0 

0 

0 

0 

0 

0 

0 

30 : 

.00 

.00 

.00 

.00 

.00 

31 : 

.00 

.00 

.00 

.00 

.00 

32: 

.00 

.00 

.00 

.00 

.00 

3s: 

.00 

.00 

.00 

.00 

.00 

34: 

.00 

.00 

.00 

.00 

.00 

35: 

.00 

.00 

.00 

.00 

.00 

36 : 

.00 

.00 

.00 

.00 

.00 

37: 

A2  3828 

AIR 

CONO 

F/UA 

9000  8TU 

01833 

30  0 

1 

2 

3a: 

8  89 

99  3 

9  98 

998 

998 

998 

996 

33: 

.00 

.00 

.25 

.25 

.50 

40 : 

.00 

.00 

.25 

.25 

.50 

41 : 

.00 

.00 

.  25 

.25 

.50 

42 : 

.00 

.00 

.25 

.25 

.50 

43 : 

.00 

.00 

.25 

.25 

.50 

44 : 

.00 

.00 

.25 

.25 

.50 

45 : 

.00 

.00 

.  25 

.25 

.50 

* 

46 : 

A2 4044 

AIR 

CONO 

18000  BTU 

01833 

30  0 

1 

2 

47: 

53 

5  3 

53 

55 

55 

55 

55 

49: 

.OU 

.00 

.00 

.50 

.50 

49: 

.00 

.00 

.00 

.50 

.50 

so: 

.00 

.00 

.00 

.50 

.50 

si : 

.00 

.00 

.00 

.50 

.50 

52: 

.00 

.00 

.00 

.30 

.70 

53 : 

.00 

.00 

.00 

.30 

.70 

54: 

.00 

.00 

.00 

.30 

.70 

55 : 

A2  4318 

AIR 

CONO 

18000  BTU 

01833 

30  0 

1 

2 

56: 

15 

25 

42 

57 

63 

83 

97 

57: 

.00 

0 

0 

• 

.25 

.75 

.00 

Figure  III.7.4 
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» 


-arc  .  iWDSr  »«•»*  ■ 


UNCLASSIFIEO«««EXAHPLE  of  output  data  missed/itmid-codes  from  utility  itmio/temp 


i: 

A9D118 

2: 

A9 

0123 

3: 

A9 

03  44 

4 : 

J8 

8047 

s: 

L4 

50  IE 

6: 

L4 

50G3 

7*. 

LS 

7040 

5: 

L5 

2041 

9: 

L5 

7042 

10: 

L9 

1701 

11 : 

L9 

22  GO 

1?: 

L9 

59  39 

13: 

Ml 

If  21 

14 : 

zo 

0570 

15: 

Z2 

14  89 

if: 

Z4 

3971 

it: 

Z4 

39  99 

is: 

Z4 

4712 

19: 

Z5 

0159 

20 : 

ZE 

7e20 

21: 

ZE 

El  50 

22: 

Z9 

3241 

ARM T  SS  HEL  7.E2MM  M2  3 

ARM  T  SS  HEL  7.G2MM  M2  A 

ARM  T  SS  HEL  7.62MM  M4  1 

INSTL  KIT  ELEC  EO:  MK 1 5  2/GSG- 

LCHR  RK T  ACFT  M158A1 

LCHR  RKT  ACri  M200A1 

LENS  CONE  A  R  LA-370A 

LENS  CONE  A  R  LA-37IA 

LENS  CONE  A  R  LA-372A 

MG  CAL. 50  HVY  FIXED 

MG  7.S2MM  ACFT  LT 

MAINT  A  K  MK-1192/ARM 

MASK  CRR  PROT  ACFT  M2  4 

AERIAL  RAOIAC  AN/AOR-S 

DETECT  SET  AN/APR39V2 

MICNS  AIR  DATA  TML  (R  FV 

MISSION  PAYLOAD  NIGHT  I  PVI 

MOUNT  GM  LCHR  DRAGON 

POSITION  LOC  RPT  ABN  U 

AIR  VEHICLE  (RPV) 

MISSION  PAYLOAD  DAYLTGH  IRPV) 
TRK  COO  10T  MLRS  RESUFP  Y 


Figure  III.7.5 
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CHAPTER  8 
UTILITY  -  TOE/ISTRUN 


8.1  DESCRIPTION:  The  objective  of  this  utility  is  to  extract  from  the  Table  of 
Equipment  (TOE)  Master  File  obtained  from  FASTALS,  authorized 
LINCODES  and  quantities  by  unit  type  and  place  them  into  the  output  file 
TOE/1ST  RUN.  This  function  is  accomplished  by  comparing  the  nine 
character  Standard  Requirements  Codes  (SRC)  of  the  TOE  Master  File  with 
the  SRC's  of  the  Arrayed  Units  files,  which  is  generated  by  the  study.  When 
a  match  is  detected,  the  appropriate  information  is  extracted  from  the  TOE 
Master  File  and  written  to  the  output  file.  The  TOE  master  file  is  provided 
by  the  Support  Forces  Group.  It  is  generated  by  matching  a  current  total 
army  troop  list  and  TOE  tapes  obtained  from  USAMSAA. 

The  newly  created  TOE/lst  RUN  file  will  be  used  as  input  to  the  utility 
SCRUB/TOE. 

8.2  STRUCTURE  -  The  general  structure  for  this  utility  is  depicted  in  Figure 

M.8.1 

8.3  DATA  BASE  -  The  utility  uses  four  files  as  its  data  base;  two  as  input  and 
two  as  output.  All  four  files  are  stored  on  mass  storage  devices  and  are 
elements  under  the  general  file  SECRET*82WARFP88.  The  individual  files 
themselves  are  discussed  in  more  detail  in  following  sections. 

SA  RUNSTREAM  -  Figure  III.8.2  displays  the  runstream  that  is  used  to  execute 
and  control  the  running  of  this  utility.  The  runstream  is  cataloged  as  an 
element  called  TOE/lst  RUN  under  the  file  name:  CSTART*82XQT.  As  it 
executes  the  runstream  accomplishes  the  following  functions. 

o  Assigns  the  TOE  Master  File  from  FASTALS,  in  this  example 

82USTOEM,  to  the  logical  unit  8  for  processing. 

o  Assigns  to  logical  unit  88  the  general  file  SECRET*82WARFP88  (i.e., 
the  file  which  contains  the  elements  for  the  current  study)  and  requires 
the  user  to  supply  the  appropriate  password  to  gain  access. 

o  Assigns  to  logical  unit  7  the  ARRAYED/UNITS  file  which  was  found 
under  SECRET*82WARFP88. 

o  Executes  the  utility. 

o  Copies  to  permanent  files  the  output  files  TOE/lstRUN  and 

UNMATCHED/UNITS  and  prints  out  20  lines  of  the  TOE/lst  RUN  for 
verification. 

o  Releases  the  allocated  logical  units  used  in  the  utility. 


V 


8.5  INPUT  -  As  noted  earlier  this  utility  was  two  data  sets  as  input  file.  The 
first  file  is  the  FASTALS  TOE  Master  File  which  is  obtained  from  the 
Support  Forces  Group,  Forces  Analyses  Directorate,  1JSACAA.  The  file  is  a 
copy  of  the  FASTALS  TOE  data  for  the  outyear  of  the  current  WARF 
study.  The  second  input  data  set  is  the  ARRAYED/UNITS  file  which  is 
normally  created  manually  using  the  system  editor  and  data  from  the 
current  study's  program  file.  Both  files  are  sorted  in  ascending  order  based 
upon  the  9  character  SRC  code. 

Figure  III.8.3  depicts  the  record  layout  and  sample  data  for  the  FASTALS 
TOE  Master  File.  Figure  III. 8. 4  depicts  the  record  layout  and  sample  data 
for  the  ARRAYED/UNITS  file. 

FILE;  FASTAL  TOE  Master  File 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  FASTAL  TOE  MASTER  FILE 


RECORD  FORMATS: 


Position 

Description 

Format 

1 

Record  Type  =  A(Header  Record) 

1A 

2  -  10 

Standard  Requirements  Code/TOE# 
(obtained  from  TOE  Master  File 

A9 

(FASTAL)) 

1 

Record  Type  -  "B"  (Detail  Record) 

1A 

2  -  7 

LINCODE 

A6 

8-11 

Quantity  Authorized  for  each  line 

14 

FILE:  ARRAYED/UNITS 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  Manually  created  using 
data  supplied  by  the  study 
team  which  describes  the 
various  unit  types  by  SRC 
found  in  the  stylized 
posture  arrays. 

RECORD  FORMAT: 


Position 

Description 

Format 

1 

Blank 

IX 

2  -  10 

Standard  Requirements  Code 
(SRC)/TOE  number) 

A9 

11-12 

Blanks 

2X 

96 

f 


13-37  Nomenclature  of  Type  Unit  A25 

3S  -  41  Type  Unit  Code  Number  A4 

(originated  by  WARF  Analyst) 

8.6  OUTPUT  -  This  utility  produces  two  data  sets  as  output.  The  first, 
UNMATCHED/UNITS,  is  simply  a  list  of  units  for  which  an  SRC  match  with 
the  TOE  Master  File  could  not  be  made.  The  second  file,  TOE/lst  RUN,  is  a 
compilation  of  all  units  for  which  an  SRC  match  was  made  and  the  list  of 
major  items  of  equipment  which  is  authorized  for  the  unit.  The  file  has  two 
major  record  types. 

The  first  record  type  of  which  there  will  be  one  for  each  unit,  describes  the 
unit  with  its  SRC  nomenclature,  and  Unit  ID  number.  The  second  record 
type,  of  which  there  can  be  one  or  more,  denotes  each  item  of  equipment, 
identified  by  its  UNCODE,  assigned  to  the  unit  and  the  quantity  of  the  item 
authorized. 

This  file  will  be  used  as  input  to  the  following  utility  SCRUB/TOE. 


Figure  111.8. 5  depicts  the  record  layout  for  the  UNMATCHED/UNITS  file. 
Figure  I1I.8.6  displays  the  record  layout  for  the  TOE/lst  RUN  file  and 
present  an  example  of  the  data  that  can  be  found  in  the  file. 

FILE:  UNMATCHED/UNITS 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  UTILITY  -  TOE/lst  RUN 

RECORD  FORMAT: 


Position  Description  Format 

RECORD- 1 

1  -  27  Character  String 

RECORD-2 

1  -  9  Source  Requirement  Code  (SRC)  A9 

FILE:  TOE/lst  RUN 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  UTILITY  -  TOE/1ST  RUN 

RECORD  FORMATS: 

Position  Description  Format 

Standard  Requirements  Code 
Blanks 


I  -  9 
10  -  14 


A9 

5X 


15  -  39 

Nomenclature  of  Unit  Type 

A25 

40  -  45 

Blanks 

6X 

46  -  49 

Type  Unit  ID  Number 

A4 

1  -  5 

Blanks 

5X 

6-11 

LINCODE 

A6 

12  -  13 

Blanks 

2X 

14  -  17 

Quantity  of  this  line  item 

14 

8.7  PERFORMANCE  -  The  execution  of  this  utility  requires  the  following  re¬ 
sources: 

CORE: 

CPU  TIME: 

CLOCK  TIME: 

DISK  UNITS: 

COMMENTS: 


15K  OR  LESS 
15  MIN  OR  LESS 
20  MIN  OR  LESS 
1  -  2 
NONE 


TOE/1 STRUN  STRUCTURE 


1 

4 

1 

1 

i 


Figure  IU.8.1 


UNCUS  SI  FI  ED  ••  •*  II  r  NAMr  :CSTART«92  XOT  rLTfFNT  N  AMS :  TDE/1S  TRuN»  •  »UNCL  A  SS  IF  ir  0 
iraASG.A  a2usTcr*. 

2:S«S5,N  T  Hr  AGO  VE  DATA  FILE  WAS  PREPARER  FROM  7HF  FASTALS  “ASTER 

3:ansG.N  tof  data  file.  which  is  maintained  by  support  fcrcfs 
<t:SMSG.N  GROUP.  FORCE  ANALYSIS  DIRECTORATE.  USACAA.  THE  TILE  IS  AN 
SISMSG.N  EXACT  DUPLICATE  OF  THE  FASTALS  TOE  DATA  FOR  THE  CUTYCA* 
t  :  a  MS  G  •  N  OF  THE  CURRENT  WARF  STUDY.  { 

7:auSE  3..82UST0EM. 
s:ausr  38..SCCRET.82VARFP88. 

GtaASG.A  88/  /  . 

io:3asg,t  t. 

li:aED  86  .ARR  AYSD/UNI  TS  .7. 

12  :c  xi  t 

ljraMSG.N  THE  ABOVE  ELEMENT  FILE  CONTAINS  THE  VAPTOUS  TYPE  OF  UNITS 
lWiaMSG.N  BY  SRC  FOUND  IN  THE  F  CUR  STYLIZED  POSTUPEC  ARRAYS  PREPARED 
lSiaMSG.N  BY  THE  STUDY  TEAM  FOR  HIGH  RESOLUTION  GAMING. 

18  ta  AS  G.  T  s. 

17  ta  AS  G.  T  10. 

;.8:aXGT  82XQT.  TCE/1STRUN 
l3:8E0  9.  .88.  TCC/1STRUN 

ro;p  20 

21  :l  AS  t 

22  :e  XI  T 

23:aMSG.N  THE  A  30  VE  ELEMENT  FILE  "TOE/ISTRUN*  CONTAINS  THE  TOE’S 
2«:aMSG.N  FOR  THE  VARIOUS  TYPES  OF  UNITS  cOUNC  IN  THE  FOUR  STYLIZED 
25:aMSG.N  POSTURE  A  RR  AYES. 

2&:aE0  10..88.UNMATCHE0/UNITS 

27  :l  NP  > 

28  :exit 

79  IS  MS  G.  N  THE  ABOVE  ELEMENT  FILE  *UNMATCHFD/UNITS*  WILL  PROVIOE 
loraMSG.N  a  listing  or  all  units  for  which  a  src  match  with  the 

11  18MEG.N  TOE  MASTER  FILE  COULO  NOT  BE  FOUND. 

32:3FRCE  7. 

ii :a free  e. 
i*  :a  FR  EE  9. 

ISUFREE  10. 

3E  IB  FR  EE  88. 


Figure  III.8.2 
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UNCLASSIFICO»««EXAMPLC  OF  DATA  FILE  B2USTOEM  I  FAST  ALS  MASTER  TOC)»»» UN CLASSIFIED 


* 


T 


i  iaoioeegboo 
?  :b  AO  32100001 
3  18  A309  460002 
«  :a  AT  20600002 
5  :B  AS  52  93U001 
E  IB  A722G00002 

7  :B  A9 01 1B0004 

8  :B80712E0001 

9  :B  BE  77860002 

10  :8  CS  26010001 

11  I8C5  30120001 

12  IB  CE  97190012 

13  :B  C6  98  560004 

14  :BC8  42270001 

15  :8C8477S0001 

16  :BCS 62130001 
17:bC8  914S0110 
18  :BC8  92130110 
191807  94810001 
201B0S01160001 

21  IB  09  OS  38U001 

22  IB  09  98880001 
2’  1609  902S0001 

24  1BE0  05  330002 

25  1BE108  350001 

26  19  E2  42  810001 
27IBE3  30830001 
29  IB  £4  57660003 

29  IB  E4  58  200005 

30  1BE5  86010002 

31  18  E7  Ob  64  0001 
321BE7  02010001 

33  1BE7  08  170001 

34  IB  E8  45  310001 

35  18  G4  45690001 

36  IB  G8  52020001 
3718  HO  23000001 
39IBHB  38170002 

39  IB  J4  29  760001 

40  IB  J4  39180003 

41  IB  J4  61 100002 

42  IB  J4  76170001 

43  IB  J4  90550001 

44  IB  J4  9398  0002 

45  IB  J5  43  300001 

46  IB K?  38140001 

47  IBK2  53420008 

48  IBK3  10420002 
49IBK317950004 
50IBK8  72430001 
51  IB  KB  72690001 
52IBKe  72730001 
53IBK9  73190001 

54  I8K9  32510001 

55  18  L009  84  0001 
56IBL105  320004 
57  IB  L4  45  95  0006 


Figure  III.8.3 
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UNCt »SSlrl ED •  ••! X4WPLE  or  ARRAY! 0/ UNIT  S  0«T»  f ILt» •♦UNCI AS Sir IEO 


l : 

Q3087H700 

NBC  DEF  CO 

CHOI 

2 : 

05145M710 

C0T  ENG  BN 

EN02 

* : 

05146H700 

HHC  ENG  BN 

EN03 

*: 

05  24  7H000 

ENG  CO 

FN04 

5: 

□5  148H71Q 

B RG  CO 

EN05 

6 : 

06  30  2H00D 

HHB  D  TV  ARTY 

FA06 

7: 

06  365HOOO 

155MM  SP  BN 

FA07 

8: 

06  366H000 

HHB  155  MM  BN 

F  AO  8 

9: 

06  36  7HOUO 

155NH  BTRY 

FA09 

10 : 

06  36  9H000 

SVC  B  TP  Y  155HN 

F  A 10 

11 : 

06  39  5B110 

8 “/GSRS  8  N 

FA11 

12: 

06  3968110 

HHB  8-/GSRS  BN 

FA12 

is: 

06  39 78 000 

8-PTRY 

FA1J 

18 : 

06  39 38 100 

GSRS  BTRY 

F  A 1 4 

is: 

06  39  98  000 

SVC  BTRY  8" /GSRS 

FA15 

is : 

OG 44  SHI 00 

8*  SP  BNI  CORPS) 

F  A 16 

it: 

06  44  6H100 

HHB  8“  BN  (COR  PS) 

FA17 

ib: 

06  44  7H100 

8*  RT  RY (C  OR  PS  I 

FA18 

19: 

06  44  9W200 

SVC  8TRY  Bm  (COP  PS  1 

FA19 

20: 

06  5158000 

GSRS  0N  (CORPS) 

FA20 

212 

06  5168000 

H HP  GSRS  BN  (CORPS  ) 

FA21 

22: 

065178000 

GSRS  BTRY(CORPS) 

FA22 

23: 

0704 5H02Q 

MFCH  INF  BN 

ME23 

24 : 

07046H010 

hhc  mech  Inf  bn 

MF24 

25 : 

0^04  7H010 

MECH  INF  CO 

ME  25 

28 : 

07  04  7H9X9 

MECH  INF  PLT 

ME  26 

27 : 

07 04 3H 020 

CS  CO  INF 

Mr27 

2s: 

08 03 5H000 

MEO  BN 

M028 

29 : 

OP  03  6H  000 

HHC  MEO  BN 

M029 

30 : 

08037H000 

MEO  CO 

ND30 

3i: 

OB12  3HOOO 

CRT  SUPT  HOSRITAL  (CORPS) 

MO  3 1 

32: 

09 127H410 

MEO  A  Me  COICORPS) 

M032 

33: 

05137H200 

MED  A  IR  AMB  C  Of  CO  RPS) 

MD33 

34 : 

0903 8H 300 

ORO  CO  CO  NV  AKMOf  CORPS! 

0R34 

35: 

09  04  7H400 

SPEC  AMMO  OS  COfC  CRPS  ) 

0R35 

38: 

09 04 80 800 

SPEC  AMMO  OS/GS  C  CfCORPS 

)  OR  36 

37: 

09  26  9H800 

M NT  BTRY  HAUK(CORPS) 

AD37 

30: 

09  55  7H  510 

MISSILE  SUPT  CO 

A038 

39: 

1OO07H00O 

S 0$  CO 

QMJ9 

ho: 

10 20 7H 300 

PETRL  PLITML  OP  C C ICO RPS ) QM40 

hi  : 

1103  5H000 

signal  bn 

SC41 

42 : 

U036HU00 

hhc  sir,  BN 

SC42 

43 : 

1103 7H 000 

C MO  OPS  CO 

SC4  J 

44 : 

11033H000 

F  WO  COMM  CO 

SC4  4 

45 : 

1103  9H0Q0 

SIG  SUPT  OP  CO 

SC45 

46 : 

1201 7H610 

AG  CC 

A  G4  6 

47: 

14037H610 

F  IN  CO 

FC47 

48: 

17004H000 

HHC  ARMO  OIV 

AR48 

44: 

17035H010 

TANK  1D5MM  BN 

AR49 

so : 

17036HOOO 

HHC  TANK  BN 

AR50 

si : 

17037H010 

TANK  105MM  CO 

AR51 

52: 

17  03  7H  9X9 

TANK  105MM  PLT 

AR52 

53: 

17Q39HOOO 

CS  CO  tank 

AR53 

54 : 

1704  2H000 

HHC  ARMO  BOF 

CA54 

55 : 

17 105HU20 

ARMO  CAV  SOON 

CA55 

56: 

17 106H000 

MHT  CAV  SOON 

CAS6 

57: 

17  108HOOO 

AIR  CAV  TRP 

CAST 

Figure  IH.8.4 
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( 


i 


} 

4 

} 

| 

UNCLASSIFIED*»*EXAMPLF  OF  OUTPUT  FROM  UTILITY  TOF/ISTPUN  i 

i:peached  FNO  of  filf  ON  FND=95  , 

2  J 1 22  55  H700 


Figure  III.8.5 
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UNCL  AS  SI  FIEO  •  •«£  X*HPLE  OF  OUTPUT  FROM  UTILITY  TOE/1STR  UN*»  *UNCL*SS  IF  IE  0 
1  :03U87H700  N8C0EF  CO  CHOI 


2 : 

*32316 

1 

3: 

*32444 

9 

4 : 

*32540 

9 

5 : 

*72260 

1 

f : 

84  9272 

111 

7 : 

86  7766 

10 

s : 

C5  2601 

1 

9: 

C5 3012 

1 

10: 

CS3149 

2 

11: 

C89145 

83 

12: 

C89213 

83 

is: 

EU0533 

12 

14 : 

E4  5820 

1 

15 : 

£70064 

1 

16 : 

F8188U 

9 

17: 

J4  3918 

11 

181 

J4611U 

1 

19  1 

K87243 

9 

20: 

K87269 

4 

21 : 

K87392 

1 

22 : 

K8739I 

1 

23: 

K8  74  56 

1 

24 : 

L44595 

10 

25 : 

L6  3994 

1U 

26: 

L92386 

13 

27: 

Ml  1896 

111 

28 : 

M7S714 

13 

29 : 

M8000r 

1 

30 : 

N5  4691 

1 

3i : 

N96741 

1 

32: 

P43177 

2 

33 : 

P9  56  92 

9 

34 : 

01  93  39 

18 

35 : 

019681 

1 

36 : 

02  09  35 

38 

37: 

021483 

19 

39 : 

05  3U01 

4 

39 : 

054174 

4 

40 : 

Q56783 

6 

41 : 

078282 

1 

42: 

R73791 

9 

43: 

R94977 

110 

44 : 

0013 05 

2 

45 : 

V15U18 

9 

46 : 

V31211 

6 

47 : 

032593 

1 

48 : 

032867 

1 

49 : 

03  3004 

7 

so : 

05  1910 

1 

51 : 

09  54  00 

13 

52 : 

095811 

11 

53: 

X39447 

1 

54 : 

X4014C 

11 

55: 

X40968 

9 

56 : 

X58367 

1 

57: 

X6  08  33 

13 

Figure  III.8.6 
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CHAPTER  9 
UTILITY  -  SCRUB/TOE 

9.1  DESCRIPTION  -  The  purpose  of  this  utility  is  to  eliminate  all  major  items  of 
equipment  from  the  TOE/lst  RUN  which  are  not  being  played  in  this  study. 
The  resulting  file  is  referred  to  as  the  SCRUBBED/TOE.  To  accomplish  this 
function  the  TOE/1STRUN  utility  was  produced  by  the  TOE/1STRUN  utility 
and  passed  against  the  LINCODE/LIST  file  which  was  created  manually 
earlier  from  the  hard  copy  list  of  LINCODES  provided  by  the  study's 
sponsor.  Only  those  items  in  the  TOE/1STRUN  file  for  which  a  match  can 
be  made  in  the  LINCODE/LIST  file  will  be  copied  into  the  SCRUBBED/TOE 
file  and  will  continue  in  the  study. 

9.2  STRUCTURE  -  The  general  structure  of  this  utility  is  depicted  in  Figure 
111.9. 1. 

9.3  DATA  BASE  -  The  utility  uses  three  files  in  its  data  base,  two  as  input, 
TOE/lst  RUN  and  LINCODE/LIST,  and  one  as  output,  SCRUBBED/TOE.  All 
three  files  will  be  cataloged  as  elements  under  the  study's  general  file,  in 
this  current  example  SECRET*82WARFP88.  Each  file  is  discussed  in  more 
detail  in  the  following  sections. 

9.4  RUNSTREAM  -  Figure  III. 9. 2  displays  the  runstream  that  is  used  to  execute 
and  control  the  utility.  The  runstream  is  cataloged  as  an  element  called 
SCRUB/TOE  under  the  general  file  CSTART*82XQT.  As  it  executes  the 
utility  accomplishes  the  following: 

o  Assigns  to  logical  unit  88  the  general  file  for  the  current  study.  In  this 
example,  SECRET*82WARFP88  where  it  further  requires  the  user  to 
provide  the  password  in  order  to  gain  access  to  the  file. 

o  Assigns  the  logical  unit  3  to  the  file  LINCODE/LIST. 

o  Assigns  the  Logical  Unit  2  to  the  file  TOE/lst  RUN. 

o  Executes  the  utility. 

o  Copies  from  the  logical  unit  7  to  the  file  SCRUBBED/TOE  under  the 
current  study's  general  file. 

o  Releases  the  resources  allocated  to  run  the  utility. 

9.5  INPUT  -  The  SCRUB/TOE  uses  two  files  as  input  data  files.  One  file  is  the 
TOE/1ST  RUN  file  which  was  created  during  the  TOE/lst  RUN  utility  which 
must  be  completed  prior  to  the  execution  of  this  utility.  This  file  identifies 
the  units  which  are  being  analyzed  under  this  current  study.  In  addition, 
each  unit  contains  detailed  items  of  equipment  which  has  been  assigned  to 
the  unit  and  the  respective  quantities  for  each  item.  Figure  111.9.3  presents 
the  file  layout  and  examples  of  the  data  found  in  the  file. 
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FILE:  TOE/1ST  RUN 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  UTILITY  -  TOE/1ST  RUN 

RECORD  FORMATS: 


Position 

Description 

Form; 

1  -  9 

Standard  Requirements  Code 

A9 

10  -14 

Blanks 

5X 

15  -  39 

Nomenclature  of  Unit  Type 

A25 

40  -  45 

Blanks 

6X 

46  -  49 

Type  Unit  ID  Number 

A4 

1  -  5 

Blanks 

5X 

6-11 

LINCODE 

A6 

12  -  13 

Blanks 

2X 

14  -  17 

Quantity  of  this  line  item 

14 

The  second  file  used  as  input  to  this  utility  is  the  LINCODE/LIST  file.  This 
file  is  created  manually  using  the  hard  copy  list  of  LINCODES  of  the  equip¬ 
ment  items  which  are  being  analyzed  in  this  study.  This  list  of  LINCODES  is 
provided  by  the  study's  sponsor.  Figure  III. 9. 4  presents  the  record  layout  and 
examples  of  the  data  found  in  the  file. 

FILE:  LINCODE/LIST 

STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  Manually  created  by  study 

personnel.  Contains  the 
complete  list  of  line  codes 
being  considered  by  the 
current  study. 

RECORD  FORMAT: 

Position  Description 

1  Blank 

2  -  7  LINE  CODE 

9.6  OUTPUT  -  This  utility  produces  one  file  as  output,  the  SCRUBBED/TOE 
file.  It  is  cataloged  under  the  current  studies  general  file,  in  the  current 
example  SECRET*82WARFP86.  This  file  uses  the  same  record  layout  as  the 
TOE/lst  RUN  input  file  to  this  utility.  Further,  while  this  new  file  contains 
all  the  units  as  the  input  file,  it  has  eliminated  from  it  all  items  of  equip¬ 
ment  which  are  not  being  analyzed  in  this  study.  If  the  item  is  not  in  the 
LINCODE/LIST  file,  it  will  not  be  in  the  resulting  SCRUB/TOE  file. 

Figure  IU.9.5  depicts  the  record  layout  for  the  file  and  an  example  of  the 
data  that  can  be  found  in  it.  Once  again  the  record  layouts  for  the 
SCRUB/TOE  and  TOE/lst  RUN  are  identical. 


Format 

IX 

A6 
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FILE:  SCRUBBED/TOE 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  UTILITY  -  SCRUB/TOE 

RECORD  FORMATS: 


Position 

Description 

Form; 

1  -  9 

Standard  Requirements  Code 

A9 

10  -  14 

Blanks 

5X 

15  -  45 

Nomenclature  of  Unit  Type 

A31 

46  -  49 

Type  Unit  ID  Number 

A4 

1  -  5 

Blanks 

5X 

6  -  11 

LINCODE 

A6 

12  -  13 

Blanks 

2X 

14  -  17 

Quantity  of  this  Line  Item 

14 

9.7  PERFORMANCE  -  The  execution  of  this  utility  requires  the  following 
resources: 


CORE: 

CPU  TIME: 
CLOCK  TIME: 
DISK  UNITS: 
COMMENTS: 


10K  OR  LESS 
10  MIN  OR  LESS 
15  MIN  or  LESS 
1  -  2 
NONE 
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UNSLASSIFIEO...F  ILE  NAMF:CSTART.32XGT  ELEMENT  NAMEISCRU  3/TOE. ••  UN  CLASSIFIED 

i:SUSE  38.. SECRET. 82WARFP88. 

2ISASG.A  38/  / 

3:SAS0.T  3. 

4  13E0  88  .LINCODE/LIST,  3. 

5  :EXI  T 

GISMSS.N  THE  A90VE  ELEMENT  FILE  ‘LINCODE/LIST-  CONTAINS  A 
TtSMSC.N  COMPLETE  LIST  OF  THE  UN  CODES  BEING  CONSIDERED  BY  THE 
8  13  MS  G.  N  CURRENT  study. 

9:a*sc.T  2. 

10:aED  86  .T0E/1STRUN.2. 

ii  :exit 

12:SMSG.N  THE  ABOVE  ELEMENT  FILE  "TOE/ISTRUN"  CONTAINS  THE  OUTPUT 
lllaMSG.N  OF  THE  UTILITY  "  8  2X  <JT  .  TOE /I  STRUN‘  . 

14  :a  AS  G»  T  7. 

15:aASG.A  92  XQ  T. 

16:aXQT  32XOT.  SCRU3/T0E 

17  I  a  ED  7.  .83.  SCRURBED/TOE 

18  IP  2D 
19:LAST 
2D ‘.EXIT 

2i:«MSG.N  THE  ABOVE  ELEMENT  FILE  ‘  SCRUBBED/  TOE"  CONTAINS  THE  CUT- 

22  13  ME  G.  N  PUT  OF  THIS  UTILITY.  WHICH  ONLY  INCLUDES  THE  TOE  AUTHFR 12  AT  IONS 

23:aMSG.N  FOR  THOSE  LIN  CODES  BEING  CONSIDERED  BY  THIS  WARF  STUDY. 

24  :a  FR  EE  2. 

25  :aFR  EE  3. 

26  13FR  EE  7. 

27:«FPEE  88. 


Figure  III. 9. 2 


uncl*ssifieo«*»ex*mplc  of  output  from  utility  toe/istrun...uncl»ssifieo 


i:03U87H700  NSC  DEF  CO 


2 : 

*32316 

1 

3 : 

*3  24  44 

9 

4 : 

*3  2540 

9 

5 : 

*72260 

1 

6 : 

849272 

111 

7 : 

867766 

10 

8 : 

C5  2601 

1 

9 : 

C5  3012 

1 

lo : 

CS  3149 

2 

n : 

C89145 

83 

12 : 

C89213 

83 

13 : 

EU0533 

12 

14 : 

E45820 

1 

is : 

E7U064 

1 

is : 

F8188U 

9 

17 : 

J4  3918 

11 

18  1 

J4611U 

1 

19  1 

K87243 

9 

20 : 

K87269 

4 

21 : 

K87392 

1 

22 : 

K8  73  93 

1 

23 : 

K87456 

1 

24 : 

L44595 

10 

25 : 

L6  3994 

1U 

26  T 

L92386 

13 

27: 

Ml  1895 

111 

28 : 

M7  5714 

13 

29 : 

M80002 

1 

30 : 

N5  46  91 

1 

31  : 

N9  6  741 

1 

12 : 

P4  3177 

2 

33 : 

P95592 

9 

34 : 

Q19339 

18 

35  1 

019681 

1 

36 : 

02  09  35 

38 

37 ; 

Q2  14  8  3 

19 

39 : 

05  3001 

4 

39 : 

QS4174 

4 

40 : 

056783 

6 

4i : 

078282 

1 

42 : 

R73791 

9 

43 : 

R94977 

110 

44 : 

UO 1 305 

2 

45 : 

VI 5018 

9 

46 : 

V31211 

S 

47 : 

W32593 

1 

48 : 

W3  28  6  7 

1 

49 : 

W3 3004 

7 

so : 

W5  1910 

1 

si : 

W9  54  00 

13 

52 : 

W9S811 

11 

53 : 

X 3 94 4 7 

A 

54  : 

X  4  0 1  4  6 

11 

55 : 

X4Q968 

9 

56 : 

X58367 

1 

57 : 

X608  33 

13 
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CHAPTER  10 


UTILITY  -  TOE/ADD-PLTS 

10*1  DESCRIPTION  -  The  purpose  of  this  utility  is  to  identify  those  units  in  the 
SCRUBBED/TOE  file  which  are  in  fact  platoon  size  units  rather  than 
company  size  units  and  correspondingly  divide  the  quantity  issued  the  unit 
for  each  authorized  item  of  equipment  by  3,  (This  factor  can  be  varied  if 
needed). 

A  second  file  is  also  used  as  input  to  this  utility.  This  file  contains  those 
units  which  have  been  flagged  as  platoon  size  units.  Using  this  file  the 
utility  is  able  to  identify  those  platoon  size  units  in  the  SCRUBBED/TOE 
file,  make  the  necessary  adjustments  in  the  quantities  of  equipment 
authorized,  if  necessary  and  write  to  the  output  file  (FINAL/TOE)  the  unit 
identification  and  the  equipment  description  and  quantity  data.  The  study 
manager  is  responsible  for  the  creating  of  the  PLATOONS  file.  This 
FINAL/TOE  file  is  the  sole  output  of  this  utility  and  is  used  as  input  to  the 
following  RAM/MATRIX  utility. 

10.2  STRUCTURE  -  Figure  III.  10. 1  depicts  the  general  structure  of  this  utility. 

10.3  DATA  BASE  -  The  data  base  which  is  used  by  this  utility  consists  of  two 
input  files  and  one  output  file.  The  input  files  are  the  SCRUBBED/TOE 
file  which  was  produced  by  the  earlier  SCRUB/TOE  utility,  and  the 
PLATOONS  file  which  is  manually  produced  by  the  study  manager  using 
the  system  editor.  The  output  file  FINAL/TOE  uses  the  same  record 
layout  as  the  SCRUBBED/TOE  file;  however,  the  quantity  data  for  equip¬ 
ment  for  those  units  which  have  been  flagged  as  being  platoon  size  units 
has  been  scaled  down  by  a  factor  of  three. 

All  files  which  make  up  the  data  base  reside  on  mass  storage  devices  and 
are  cataloged  as  elements  under  the  current  study's  general  file;  in  the 
current  example,  this  file  would  be  SECRET*82WARFP88. 

10.4  RUNSTREAM  -  The  runstream  which  is  used  the  execute  and  control  this 
utility  is  displayed  in  Figure  III.  10.2.  The  runstream  is  cataloged  as  an 
element  under  file  CSTART*82XQT  using  element  name  TOE/ADD- 
PLTS.  As  the  utility  executes  it  accomplishes  the  following  functions: 

o  Assigns  to  the  logical  unit  88  the  study's  general  file 
SECRET*82WARFP88  and  requires  the  user  to  supply  the  proper  pass¬ 
word  to  gain  access  to  the  file. 

o  Assigns  to  logical  unit  7  the  PLATOONS  file. 

o  Assigns  to  logical  unit  8  the  SCRUBBED/TOE  file. 

o  Executes  the  utility. 
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o  Copies  the  output  file  from  logical  unit  9  to  the  permanent  file 
FINAL/TOE  under  the  current  study's  general  file. 

o  Releases  the  logical  units  allocated  for  the  execution  of  this  utility. 

10.5  INPUT  -  The  TOE/ADD-PLTS  utility  uses  two  data  files  as  its  input.  One 
file  is  the  SCRUBBED/TOE  which  was  created  as  a  result  of  the 
SCRUB/TOE  utility.  The  second  file  is  the  PLATOONS  file  which  is 
manually  created  using  the  system  online  editor.  Both  files  are  cataloged 
under  the  study's  general  file;  in  this  instance  SECRET*82WARFP88. 

The  SCRUBBED/TOE  file  is  a  collection  of  all  the  units  participating  in 
the  study  accompanied  by  a  detailed  list  of  all  items  of  equipment 
assigned  the  unit  and  the  quantity  of  the  item  authorized.  The  file  uses 
two  record  formats.  The  first  record  format  is  used  to  dscribe  the 
particular  unit  and  occurs  once  per  unit.  It  contains  such  data  as  the  units 
Standard  Requirement  Code,  nomenclature  of  the  type  of  unit,  and  the 
type  unit  ID  number.  The  second  record  type  is  used  to  describe  the  items 
of  equipment  assigned  to  the  unit.  This  record  type  will  occur  as  many 
times  per  unit  (i.e.,  first  record  type)  as  there  are  items  of  equipment 
assigned  to  the  unit  and  being  played  in  the  study.  This  record  consists  of 
two  fields.  The  first  field  identifies  the  item  of  equipment  using  its 
LINCODE.  The  second  field  denotes  the  number  of  individual  units  of  this 
item  that  are  authorized  for  this  unit.  Record  layouts  and  examples  of 
the  data  in  the  file  can  be  seen  in  Figure  III.  10.3 

FILE:  SCRUBBED/TOE 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  UflUTY  -  SCRUB/TOE 

RECORD  FORMAT: 


Position 

Description 

Format 

1  -  9 

Standard  Requirements  Code 

A9 

10  -  14 

Blanks 

5X 

15  -  45 

Nomenclature  of  Unit  Type 

A31 

46  -  49 

Type  Unit  ID  Number 

A4 

1  -  5 

Blanks 

5X 

6-11 

UNCODE 

A6 

12  -  13 

Blanks 

2X 

14  -  17 

Quantity  of  this  Line  Item 

14 

The  PLATOONS  file  contains  data  which  identifies  parent  units  of 
company  size  and  its  corresponding  platoon  size  unit.  This  file  consists  of 
one  record  type  which  describes  the  unit  by  its  Standard  Requirement 
Code,  unit  nomenclature  and  unit  ID.  The  utility  assumes  the  records  will 
be  organized  in  the  file  so  that  each  parent  unit  record  (company)  will  be 
followed  immediately  by  one  and  only  one  sub-unit  (PLATOON)  record. 
The  record  layout  and  examples  of  data  within  the  file  can  be  seen  in 
Figure  III.  10.4. 
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FILE:  PLATOONS 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  Manually  created  by  study  participants. 

RECORD  FORMAT: 


Position 

Description 

Format 

1 

Blank 

IX 

2  -  10 

Standard  Requirement  Code 

A9 

11-  12 

Blanks 

2X 

13  -  37 

Nomenclature 

A25 

38  -  41 

Identification  sequence  number 
of  unit 

A4 

OUTPUT 

-  This  utility  produces  one  output  file,  ITMID/FINAL. 
is  cataloged  under  the  study's  general  file,  in 

The  file 

element 

this  case 

SECRET*82WARFP88.  This  file  contains,  in  addition  to  all  the  data  on 
the  company  size  units,  that  was  found  on  the  SCRUBBED/TOE  file;  i.e., 
unit  identification  data  and  equipment  identification  data  and  authorized 
quantities,  information  on  platoons  which  are  subordinate  to  selected 
parent  units.  These  parent  units  and  subordinate  units  were  identified  by 
the  study  manager  and  transmitted  to  the  utility  through  the  PLATOONS 
input  file.  The  file  will  have  the  same  file  format  structure  as  the 
SCRUBBED/TOE  input  file  in  that  it  will  have  two  record  types.  The  first 
record  type  will  describe  the  particular  unit  or  subunit  and  will  occur  once 
per  unit.  The  second  record  will  describe  the  items  of  equipment  assigned 
the  unit  and  the  quantity  of  each  item  authorized.  This  record  type  will 
occur  once  for  each  item  of  equipment  assigned  the  unit.  Figure  111.10.5 
presents  the  file  layout  for  the  file  and  examples  of  the  data  that  can  be 
found  in  it. 

FILE:  FINAL /TOE 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  UTILITY  -  TOE/ADD-PLTS 

RECORD  FORMAT: 


Position 

Description 

Format 

1  -  9 

Special  Requirement  Code 

A9 

10  -  14 

Blanks 

5X 

15  -  45 

Nomenclature 

A31 

46  -  49 

Type  Unit  ID  Number 

A4 

1  -  5 

Blanks 

5X 

6-11 

LINCODE 

A6 

12  -  13 

Blanks 

2X 

14  -  17 

Quantity 

14 

PERFORMANCE  - 

This  utility  will  require  the  following  resources: 
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CORE: 

CPU  TIME: 
CLOCK  TIME: 
DISK  UNITS: 
COMMENTS: 


10K  OR  LESS 
10  MIN  OR  LESS 
15  MIN  OR  LESS 
1  -  2 
NONE 
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UNCLASSIFIED««.E  ILE  NAME  :c  START*  82  XOT  element  nake:toe/add-plts*»»unclassified 

1T3USE  88..SECRET«82WARFP88. 

218asg.a  88/  / 

3:3ASG.T  7. 

n:SED  88.  PLATOONS.  7. 

E  :e  xi  t 

6:a*sc.N  the  amove  element  file  ’platoons-  contains  the 

7:SMSG.N  PARENT  UNIT  (COMPANY  1  ANO  SU3UNIT  (  PLATOON »  DATA  BY  SRC  FOR 
STSHSG.N  INPUT  TO  THIS  UTILITY. 

SSSASG.T  8. 

lOTSEO  88.SCRUP9E0/T0E«8. 

UTEXIT 

12  IS  MS  Gf  N  THE  A30VE  ELEMENT  FILE  ’SCRUBBED/TOE’  CCNTAINS  THE 
l3:aMSG.N  OUTPUT  OF  THE  UTILITY  ’82XGT. SCRUB/TOE’ .  WHICH 
lAlSNSG.N  REELECTS  ONLY  THE  AUTHERIZEO  QUANTITIES  FOR  THOSE 
15:flMSG.N  LIN  COCES  BEING  CONSICEREO  BY  THE  CURRENT  WARF  STUDY. 

16  :®A$  S,  T  9. 

lllSASG.A  32X0T. 

lSiaxOT  82XQT.  TOE/AD  0— PL  TS 

19:aE0  9.  .88.  FI  nal/toe 

?g:p  20 

2i:last 

22  :e  XI  t 

23:anSG.N  THE  A  MOVE  ELEMENT  FILE  ’FINAL/TOE*  IS  THE  OUTPUT  OF 

7i:3MSG.N  This  utility,  this  file  will  require  additional  review 
25:3MSS.N  and  edittting  before  it  can  be  use  as  input  tc  the 
26:SMSG.N  utility  ’82XQT. RAM/HA  TRIX*. 

2t:sfree  t. 

26 :a FR EE  8. 

29:aFPEE  9. 

30  :a  ER  EE  88. 


Figure  III.  10.2 
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a : 

J4811U 
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L4  4595 
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M75714 
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n : 

U8S741 

1 

l? : 

P4  3177 
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PS  5582 

9 

14 : 

0183  39 

IS 

18 : 

020935 

38 

ie  : 

02 14  83 

19 

1? : 

05  3001 

4 

18 : 

054174 

4 

is : 

056783 

E 

20 : 

079232 

1 

21 : 

P94977 

110 

22 : 

UO 1305 

2 

23  : 

VI 5018 

9 

74 : 

V31211 

E 

2s : 

U32593 

1 

2E : 

W9  54  00 

13 

27: 

U9SB11 

11 

28: 

X  3  94  4  7 

1 

28 : 

X4U14C 

11 

30 : 

X409E8 

9 

31 : 

X58367 

1 

3? : 

XE  08  33 

13 

33 : 

XE  32  99 

1 

34  :05145H710 

C8T 

35 : 

A3  24  44 

10 

38 : 

88  3582 

2 

37 : 

88 3356 

18 

38 : 

88  44  04 

27 

33 : 

C2U414 
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4o: 

C25757 

2 

4i : 

C85494 

3 

42 : 

C86213 

1 

43 : 

011538 

3 

44 : 

012087 

40 

45 : 

E00533 

24 

4E : 

E4  58  20 
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47 : 

F56578 
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48 : 

EE  9242 

1 

43 : 

F70064 
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so: 

F7088E 
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si : 

E736  26 
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52 : 

F39373 

3 

S3 : 

F81S8U 

1 

54 : 

GO  2204 

«*8 

55 : 

GO  23  41 

5G 

5e  : 

MO  2  3  00 

2 

57: 

M3  87  87 

2 

CHOI 
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Figure  III. 10.3 
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unclassified*.*exakple  of  input  data  FILE  PLATOONS. •♦UNCLASSIFIED 


1:  07047HQ10  MFCH  INF  CO  KE25 

2:  07047H9X9  MECH  INF  PL  T  ME26 

3!  17U37HQ10  TANK  105MM  CO  AR51 

4J  17D37H9X9  TANK  105MM  PLT  AR52 

5:  17  3Q7H700  A  RMD  CAV  TRP  CA58 

6:  17307H9X9  ARMO  CAV  PLT  CA59 

7:  44  2E7H5D0  HAWK  BRTY  AD74 

81  44  267H9X9  HAWK  PLT  AD75 

9:  44  327H000  ADA  BRTY  VULCAN  AD78 

10:  44327H9X9  ADA  PLT  VULCAN  AD79 

111  44T23HD00  ADA  BTRY  CHAPARRAL  ADBO 

12:  44  328H9X9  ADA  PLT  CHAPARRAL  AD81 


Figure  III.  10.4 
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CHAPTER  II 


UTILITY  -  RAM/MATRIX 
OR 

WIMP/MATRIX 


11.1  DESCRIPTION  -  The  purpose  of  this  utility  is  to  process  and  merge  data 
from  three  files  and  develop  the  RAM/MATRIX.  The  RAM/MATRIX  is 
a  two  dimensional  array.  The  Y  axis  of  the  array  is  the  units  in  the 
study  identified  by  their  two  character  unit  codes  and  sequence 
number.  The  X  axis  of  the  matrix  consists  of  22  columns;  one  for  each 
of  the  22  vulnerability  categories  into  which  an  item  of  equipment  will 
be  classified.  (Figure  III. 11.3).  These  categories  are  used  to  group  to¬ 
gether  items  of  equipment  which  have  common  susceptibilities  to  indi¬ 
rect  fire.  The  title  of  this  utility  will  be  changed  to  WIMP/MATRIX 
when  used  with  the  WARF  Intermediate  Materiel  Processor. 

The  interior  of  the  matrix  accumulates  for  each  unit  in  the  study  the 
number  of  items  of  equipment  the  unit  is  authorized  in  each  of  the  vul¬ 
nerability  categories. 

This  RAM/MATRIX  data  file  of  unit  type  and  item  vulnerability 
category  is  used  as  input  to  other  modules  such  as  the  Target  Acquisi¬ 
tion  Model  (TAM)  output  files,  the  TOTAL/CATEGORY  utility  and  the 
TOTAL/UNITS  utility. 

1 1.2  STRUCTURE  -  The  overall  structure  of  this  utility  is  depicted  in  Figure 
III.l.I. 

11.3  DATA  BASE  -  The  data  base  which  is  used  by  this  utility  consists  of 
four  files;  three  used  as  input  and  one  as  output.  All  files  are  cataloged 
as  elements  under  the  current  study's  general  file;  in  this  case  SECRET- 
*82WARFP88.  The  first  input  file,  ARRAYED/UNITS  is  prepared  by 
the  study  manager  and  contains  the  various  types  of  units  and  their 
nomenclature  that  are  being  included  in  the  study's  high  resolution 
arrays.  This  file  is  also  used  as  input  to  another  utility,  TOE/lst  RUN. 
The  second  input  file  to  this  utility  is  ITMID/FINAL  file  for  the  current 
study  which  was  produced  by  the  ITMID/REC-A  utility. 


Out  of  this  file  the  utility  extracts  the  vulnerability  category  assigned 
each  item  of  equipment.  The  final  input  file  used  by  this  utility  is  the 
FINAL/TOE  which  was  produced  by  the  TOTAL/ADD-PLTS  utility.  The 
utility  takes  from  this  file  the  number  of  authorized  quantities  of  equi¬ 
pment  for  each  unit  and  accumulates  these  quantities  on  vulnerability 
code. 

The  RAM/MATRIX  file  is  the  only  output  file  produced  by  the  RAM/- 
MATR1X  utility.  The  file  summarizes  or  accumulates  by  unit  type/vul- 
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nerability  code  the  number  of  items  of  equipment  which  have  been 
authorized  for  this  unit. 

RUNSTREAM  -  the  runstream  which  is  used  to  control  the  execution  of 
this  utility  is  depicted  in  Figure  III. 11.2.  The  runstream  is  cataloged  as 
an  element  under  the  general  file  CSTART*82XQT  using  the  element 
name  RAM/MATRIX.  The  utility  accomplishes  the  following  as  it  exe¬ 
cutes: 

o  Assigns  to  logical  unit  88  the  study's  general  file,  in  this  example 
SECRET*82WARFP88,  and  requires  the  user  to  supply  the  appro¬ 
priate  file  password  to  gain  access  to  it  prior  to  using  the 
runstream. 

o  Assigns  logical  unit  7  to  the  ARR AYEO/UNITS  file,  logical  unit  8 
to  the  ITM1D/FILE  file;  and  logical  unit  9  to  the  FINAL/TOE  file. 

o  Executes  the  utility. 

o  Copies  the  output  file  to  the  permanent  file  RAM/MATRIX  and 
catalogs  is  under  the  current  study’s  general  file. 

o  Releases  the  units  allocated  to  execute  the  utility. 

INPUT  -  This  utility  uses  three  data  files  as  its  input.  One  file  is  the 
ARRAYEO/UNITS  file  which  was  prepared  manually  by  the  study 
manager.  The  second  file  is  the  ITMID/FINAL  file  which  was  produced 
bythe  ITMID/REC-A  utility.  The  final  input  file  is  the  FINAL/TOE  file 
which  was  produced  by  the  TOE/ADD-PLTS  utility. 

From  these  files  the  utility  extracts  data  on: 

o  The  type  units  participating  in  the  study  Stylized  Arrays 
(ARRAYED  UNITS) 

o  Items  of  equipment  being  used  in  the  study  and  their  artillery  vul¬ 
nerability  category  (ITMID/FINAL). 

o  The  authorized  allocations  of  items  of  equipment  to  units  (FINAL/- 
TOE). 

Using  this  data  the  utility  is  able  to  produce  the  RAM/MATRIX. 

Figure  III.  11.4  depicts  the  example  data  for  the  ARRAYED/UNITS  file; 
Figure  III.  11.5  presents  the  example  data  for  the  ITMID/FINAL  file;  and 
Figure  III.  1 1.6  presents  the  file  example  data  for  the  FINAL/TOE  file. 
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FILE:  ARRAYED/UNITS 
STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  Manually  created  using  data  supplied  by  the  study  team 

which  describes  the  various  unit  types  by  SRC  found  in  the  stylized  pos¬ 
ture  arrays. 


RECORD  FORMAT: 


Position 

Description 

Format 

1 

Blank 

IX 

2  -  10 

Standard  Requirements  Code  (SRC)/ 
TOE  number 

A9 

11-12 

Blanks 

2X 

13-37 

Nomenclature  of  Type  Unit 

A25 

38-41 

Type  Unit  Number 

A4 

FILE:  ITMID/FIN  AL 
STORAGE  MEDIUM: 
SOURCE:  UTILITY  - 

Mass  Storage 

ITMID/RECA 

RECORD  FORMAT: 

Position 

Description 

Format 

1 

Blank 

IX 

2  -  7 

Line  item  number  (LIN 

A6 

8 

Blank 

IX 

9  -  38 

Alphanumeric  nomenclature 

5(A6) 

39 

Blank 

IX 

1 

o 

cl- 

Type  equipment  code  for  losses 

12 

42  -  43 

Vulnerability  class  for  losses 
from  artillery  model 

12 

44  -  45 

Classification  for  Historical  Data 

12 

00 

d- 

1 

vD 

CJ- 

In-theater  depot  stockage  (number 
of  days  supply) 

13 

49  -  50 

Fraction  of  intheater  shipment 
which  is  by  air 

F2.2 

51  -  52 

=  1  if  actual  equipment  density  is 
to  be  read  and  used 

12 
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53  -  54 


55  -  58 

1  -  49 


1  -  35 


FILE:  FINAL/TOE 
STORAGE  MEDIUM: 
SOURCE:  UTILITY  - 

RECORD  FORMATS: 

Positions 

1  -  9 
10  -  14 
15-45 
46  -  49 
1  -  5 
6-11 


-  0  if  density  is  to  be  estimated 
from  the  number  of  divisions  in 
theater 


=  1  if  combat  losses  are  from  the  12 

theater  simulation 

=  2  if  combat  losses  are  from  artil¬ 
lery  models 

=  3  if  all  losses  are  from  history 

Sequence  number  14 

Quantities  of  this  line  item  for  7(17) 

the  seven  time  periods  of  the 
exercise,  obtained  from  the  new 
ITMID/TEMP  file. 

Density  Profiles  for  Time  Period  5F(F5.2) 

N  for  this  line  item  in  each  of 

the  five  zones  or  areas  being 

played  in  this  exercise.  These 

density  prof  iles  are  obtained 

from  the  new  ITMID/TEMP  file. 

There  must  be  seven  occurrences 
of  this  record;  one  for  each  time 
period  being  played. 


Mass  Storage 
TOE/ADD-PLTS 


Description  Format 


Special  Requirement  Code 

A9 

Blanks 

5X 

Nomenclature 

A3 

Type  Unit  ID  Number 

A4 

Blanks 

5X 

LINCODE 

A6 

126 


12  -  13 
14  -  17 


Blanks 

Quantity 


2X 

14 


OUTPUT  -  The  RAM/MATRIX  file  is  the  only  output  from  the  RAM/- 
MATRIX  utility.  This  file  has  one  record  type  consisting  of  the  unit 
identification  code  and  the  22  occurrences  of  the  artillery  vulnerability 
categories.  As  the  utility  executes  it  examines  for  each  unit  type  each 
individual  item  of  equipment  which  it  has  been  authorized  and  deter¬ 
mines  the  equipment's  artillery  vulnerability  category  and  the  quantity 
of  this  equipment  this  unit  has  been  authorized  and  accumulates  in  the 
vulnerability  category  for  this  unit  the  quantity  of  items  authorized.  It 
should  be  noted  that  emphasis  in  this  process  is  on  unit  type  and  number 
of  equipment  units  in  specific  vulnerability  categories,  regardless  of  the 
specific  type  of  equipment. 

FILE:  RAM/MATRIX  WIMP/MATRIX) 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  Utility  -  RAM/MATRIX  (WIMP/MATRIX) 

RECORD  FORMAT: 


Position 

Description 

Format 

1 

Blank 

IX 

2  -  3 

First  2  characters  of  the  Unit 

Type  Code 

A2 

4  -  5 

Subscript  of  the  above  Code 

12 

-  93 

Accumulated  Quantities  for 

Lincodes  and  their  corresponding 
Vulnerability  Categories. 

2214 

Figure  III.  1 1.7  presents  the  file  layout  and  examples  of  the  data  found  in  the 


PERFORMANCE  -  This  utility  will  require  the  following  resources: 


CORE: 

CPU  TIME: 
CLOCK  TIME 
DISK  UNITS: 
COMMENTS: 


10K  OR  LESS 
10  MIN  OR  LESS 
10  MIN  OR  LESS 
1  -  2 
NONE 


RAM/MATRIX  STRUCTURE 


The  WIMP/MATRIX  program  may  be  named  in  lieu  of  RAM/MATRIX 


Figure  III. 1 1.1 


128 


unclassifieo»*»f  ile  name  :cstart«82  xgt  element  nahe:ram/matrix*«ounclassifieo 

i:ailSE  8B..SECRET«82WARFP88. 

2:8asg.a  88/  / 

3:a»SG.T  7. 

<t:aEC  88  .ARRAYED/UNZTS  »7. 

s:exit 

£  38 MS  G. N  T  HE  ABOVE  F  LE  MF  NT  FILE  *  A  RR  AYED/UNI TS*  IS  CONTAINS  INPUT  DATA  TO 

t:smsg>n  this  utility  on  the  umt  array  cooes. 

8I3ASG.T  8..///500 
S:aED  38  .ITM  ID/F  INAL  *8. 

io  :e  xi t 

li:aMSG.N  THE  ABOVE  E  LE  ME  NT  F  IL  E  *  I  TM  ID/F  IN  AL*  IS  THE  FINAL  ITMID 
12:8MSC.N  FILE  FOR  THE  CURRENT  STUDY.  IT  WILL  PROVIDE  DATA  TO 
UISMSG.N  THIS  UTILITY  ON  THE  ARTILLERY  VULNERABILITY  CATEGORIES 
l<*:aMSG.N  FOR  FACH  LIN  CODE. 

istsasg. r  9. .///s no 

ie:8ED  88.  FINAL/TOE.  9. 

17IEXIT 

18:aMSG.N  THE  ABOVE  ELEMENT  FILE  *FXnal/TOE"  IS  THE  FINAL  TOF  FOR  THE 
19:8MSG.N  VARIOUS  TYPES  OF  UNITS  FOUND  IN  THE  FOUF  STYLIZED  APRAYES. 

20 18  MS  G*  N  THIS  rILE  WILL  PR  OV  10  E  INPUT  DATA  ON  THE  AUTHERIZED 
2i:8MSG.N  QUANTITIES  OF  EQUIPMENT  (LIN  COOES)  BY  ,'YPE  OF  UNIT. 

22  38  AS  G. T  10.. ///500 

23  38  AS  G.  A  32XQT. 

24:aXGT  82XQT.  RAM/MATRIX 

25  :  a  ED  10.  .38  .RAM/MATRIX 

26  :lnp  • 

27:EXIT 

:s:8MSG.N  THE  ABOVE  ELEMENT  FILE  -RAM/MATRIX*  CONTAINS  THF  OUTPUT 
29:3MSG.N  DATA  PRODUCED  BY  THIS  UTILITY.  THIS  DATA  WILL  SERVE  AS  INPUT 

3o:bmsg.n  to  the  tam  data  file,  which  is  an  input  file  to  ram. 

31  :a  FREE  7. 

32  3  8  FR  EE  8. 

33  :a  FREE  9. 

34  18  ER  EE  10. 

35 :a fr ee  aa. 


Figure  III.  1 1.2 


ARTILLERY  (and  TACAIR)  VULNERABILITY  CATEGORIES 


Vulnerability 

Category 

Title 

Notional  Item 

1 

Light  aircraft 

Helicopter, 

light  observation 

2 

Light  armor 

Carrier, 

armored  personnel 

3 

Medium/heavy  armor 

Combat  tanks 

4 

Light  vehicles 

Truck,  1/4  ton 

5 

Medium/heavy  self- 
propelled  vehicles 

Truck,  2  1/2  ton 

6 

Light  boats  (floating 

Bridge  erection  boats 

7 

Light  towed  equipment 

Trailer,  cargo,  1/4  ton 

8 

Towed  artillery 

Howitzer,  towed;  105mm 

9 

Medium/heavy  towed 

Semitrailer,  12  ton 

10 

Medium  Recovery  Veh 

M88A1 

11 

Light  Recovery  Veh 

M578 

12 

Ammunition  transporters 

Carrier,  cargo,  6  ton 

13 

POL  transporters 

Truch,  tank,  fuel  servicing 

14 

Small  arms 

Rifle,  .5.56mm 

15 

Crew-served  weapons 

Machinegun,  7.62mm 

16 

Optical  and  illumina¬ 
tion  instruments 

Night  vision  sights 

17 

Communications/electronic 

devices 

Radio,  portable 

18 

Machines 

Generator  set,  05-10KG 

19 

Miscellaneous  small 
equipment 

Antenna,  RC-292 

20 

Medium/large  shop  sets 

Shops  equipment, 

auto  maintenance 

21 

POL  storage  equipment 

Fuel  system, 

supply  point,  6,000  gallons 

22 

Water  tanks 

Tank,  fabric,  1,500  gallon 

Figure  III.  1 1.3 
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UNCL«SSIFIEO***CX»MPL£  OF  »»B«Y£  0/  UNITS  0*T»  FILE***  UN  CLASSIFIED 


1  : 

1)3  Oft  7W  700 

NBC  dee  CO 

CHQ1 

? : 

05  14  5M710 

COT  C  NG  BN 

FNOZ 

3 : 

O1  1 4  8M  7 1*0 

MHC  ENC  8  N 

EN03 

u : 

05  14  7H000 

t  nh  co 

EN04 

05  14  9H  710 

RRG  CO 

EN05 

e : 

0€  302H000 

HHB  DIVARTY 

FA06 

7: 

06  36  5M000 

155MM  SP  BN 

FA07 

s : 

08  JSSMQOO 

MH«  1 55  KM  BN 

FAQft 

9 : 

06  3S7H000 

1  55 MM  B  TRY 

FA09 

m: 

OC  38  9H000 

5  VC  8TPY  155MM 

F  A 10 

ti : 

06  39  5B  110 

8-/GSRS  BN 

E  A  1 1 

12 : 

06  3968110 

H  HR  8 " /CS  RS  BN 

FAI2 

IM 

OC  79  7B000 

8  *  D  TR  Y 

FA1J 

14 : 

08  39  38100 

GSRS  BTRY 

FA14 

is: 

OS  39  90000 

5  VC  BTRY  8"/GSRS 

PA15 

16 : 

OC  U4  5H100 

8-  SP  BNCCOPPS) 

FA16 

it: 

or  44  6H 100 

H  HR  8"  BN  *  C  OR  PS  I 

E  A1 7 

is : 

OC  44  7H  1 00 

e-  RTRYICQPPSI 

E  A 1 8 

is: 

06  44  9H100 

5VC  BTRY  8*  (CORPS  1 

E  A 1 9 

20 : 

06  51 5B 000 

GSRS  0NICORPSI 

E  A20 

2 1: 

Of  *166000 

H  HP  GSRS  BN  (CORPS  > 

FA21 

?2 : 

OC  5170000 

CSRS  8T  RY  (C  OR  PS  1 

EA22 

2*: 

07045H020 

MECH  INF  BN 

ME  2  3 

24 : 

07046H010 

HHC  H  EC  H  INF  BN 

ME  24 

2s : 

O'*  04  7H  01 0 

MECH  INF  CO 

ME25 

?f. : 

07047M9X9 

MCCH  INF  PLT 

ME  26 

27: 

0704  3H02Q 

CS  CO  INF 

ME  2  7 

28 : 

08  03  5H000 

MFO  BN 

MO20 

29 : 

0e036H000 

HHC  MED  BN 

M029 

jo: 

08037H000 

MED  CO 

M030 

31 : 

08  12  3HOOO 

CBT  SUPT  HOSRIT  *L  (CORPSI 

MD31 

32: 

09  127H410 

MFD  *  MB  CO(CORFS) 

M032 

33 : 

09  137HZ00 

MEO  AIR  AM9  CO(COFPS) 

MD33 

34 : 

09  03  8H  300 

ORO  CO  CO  NV  AMMOI  CORPS! 

OR  34 

39 : 

09 04  7H400 

SPEC  AMMO  ns  CO  (C  CRPS  1 

OR  75 

is: 

09  04  8C800 

SPEC  AMMO  OS/GS  CCtCORPS 

?0R36 

37: 

09  76  8H800 

M  NT  B  TRY  HAWK  (COR  PS! 

AD37 

38 : 

09  55  7H  51 0 

MISSILE  SUPT  CO 

*n  38 

39: 

1O007HOOO 

zes  co 

QM  39 

so : 

10 20 7H 300 

PETRL  PL8TML  OP  C C (CO RPS 1 QM4Q 

4i : 

11035H000 

SIGNAL  BN 

SC41 

42: 

11 036HOOU 

HHC  SIG  BN 

SC42 

4.3: 

11 037H000 

CMD  CPS  CO 

SC43 

44 : 

11 033H000 

F  WO  COMM  CO 

SC44 

4*> : 

11039H000 

SIG  SUPT  OP  CO 

SC45 

48: 

12017H610 

AG  CO 

A  C  4  6 

47: 

14037HS10 

F  IN  CO 

PC47 

48 : 

1 7  00  4H  000 

HHC  ARMO  OIV 

AR  4  8 

49 : 

17035H010 

TANK  105MM  BN 

AR4  9 

so : 

17  03  SH  000 

HHC  TANK  BN 

AR  50 

si : 

17037H010 

TANK  105MM  CO 

AR51 

52: 

17037H9X9 

TANK  105MM  PLT 

AR52 

53 : 

17039H000 

CS  CO  tank 

AR53 

54 : 

1704  2H000 

HHC  ARMO  80  F 

CA54 

55 : 

17  1C.5H020 

ARMO  CAV  SOON 

CA55 

58: 

17106H000 

HHT  CAV  SOON 

CASS 

57: 

17 108HOOO 

AIR  CAV  TRP 

CAS7 

Figure  III.  1 1.4 
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UNCLASSIFI£D«»*£  XAMPLC  Of  THE  OUTPUT  OF  UTILITY  ITMID/RCC- »•  •  »UNCL  ASSIFIE  0 


1 : 

AC  3198 

AK 

VEH  M2 18  GM  EG  P1A 

0  522 

30  Q 

1 

2 : 

54 

64 

44 

58 

78 

88 

88 

3: 

.00 

.00 

.  00 

.90 

.20 

4 : 

.00 

.00 

.00 

.90 

.20 

s: 

.00 

.00 

.00 

.80 

.20 

e : 

.00 

.00 

.00 

.80 

.20 

7: 

.00 

.00 

.00 

.80 

.20 

s: 

.  00 

.00 

.00 

.90 

.20 

9: 

.00 

.00 

.00 

.75 

.25 

10: 

4147  52 

AOAP  test 

CAMERA  LM178 

01636 

30  0 

1 

11: 

ID 

16 

16 

17 

17 

17 

17 

i?: 

.00 

.00 

.20 

.80 

.00 

13: 

.00 

.00 

.20 

.80 

.00 

14 : 

.00 

.00 

.20 

.80 

.00 

15: 

.00 

.00 

.  15 

.85 

.00 

16: 

.00 

.00 

.  15 

.85 

.00 

it: 

.00 

.00 

.  35 

.65 

.00 

is  : 

.00 

.00 

.  35 

.65 

.00 
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CHAPTER  12 

UTILITY  -  TOTAL/UNITS 
AND  WIMP/TOTAL -UNITS 

DESCRIPTION:  The  purpose  of  this  utility  is  to  determine  the  total 

number  of  units  by  unit  type  in  the  RAM/MATRIX  file  within  each  of 
the  four  stylized  posture  arrays.  This  utility  is  replaced  by  the  new  pro¬ 
gram  called  WIMP/TOTAL-UNITS  when  the  WIMP  is  applied  in  lieu  of 
the  RAM  program  and  methodology.  These  four  stylized  posture  arrays 
are:  Attack  (AT),  Defense  Intense  (DI),  Delay  (Defend)  (DE),  and  DEF.- 
LIGHT  (Inactive)  (DL).  This  utility  must  be  run  once  for  each  of  the 
four  postures.  The  units  in  the  posture  arrays  will  be  identified  by  a 
second  input  file  which  is  created  by  the  arrayers  for  the  RAM 
analyst.  Each  of  the  four  runs  of  this  will  produce  two  output  files. 
One  will  identify  units  in  the  postured  array  file  for  which  a  match  on  a 
corresponding  unit  in  the  RAM/MATRIX  could  not  be  made.  The  second 
and  main  output  from  this  utility  is  a  file  which  contains  each  unit  for 
which  a  match  between  the  two  files  could  be  made  and  the  accumu¬ 
lated  total  of  the  number  of  this  type  of  unit  that  was  found  in  the 
RAM/MATRIX  file.  Each  of  these  four  TOTAL/UNIT  files  will  be  used 
as  input  in  a  following  utility,  referred  to  as  TOTAL/CATEGORY. 

STRUCTURE  -  The  overall  structure  of  this  utility  is  pictured  in  Figure 
ITU 2.1.  This  utility  is  executed  four  times,  once  for  each  combat  pos¬ 
ture. 


DATA  RASE  -  The  data  base  used  to  support  this  utility  is  more  com¬ 
plex  than  the  data  bases  which  support  previous  utilities  in  the  Materiel 
Postprocessor  system.  The  utility  must  be  run  four  times  using  two 
input  files  and  will  produce  two  output  files.  In  all  cases  the  RAM/- 
MATRIX  file  will  be  used  as  one  of  the  input  files.  The  second  input 
file  which  identifies  those  units  in  one  of  the  four  particular  postures 
and  will  change  from  run  to  run  using  the  appropriate  posture  file. 
These  four  posture  files  will  be  supplied  by  the  RAM  analyst.  The  util¬ 
ity  will  produce  two  output  files  for  each  run.  One  file  (the  MISSED/- 
UNITS)  will  identify  those  units  which  were  identified  on  the  posture 
array  file  but  not  found  in  the  RAM/MATRIX.  The  second  file  will  con¬ 
tain  all  units  which  were  found  to  be  in  the  particular  posture  and  the 
total  number  of  each  unit  in  that  posture. 

All  files  will  be  found  on  the  system  mass  storage  devices  and  be  cata¬ 
loged  as  elements  under  the  current  study's  general  file. 

RUNSTREAM  -  Figure  III.  12.2  details  the  runstream  that  is  used  to  con¬ 
trol  and  execute  the  running  of  this  utility.  Figure  III.  1 2.2 A  depicts  the 
alternate  program  runstream.  The  runstream  is  currently  cataloged  as 
an  element  under  the  file  GST ART*82XQT  under  the  element  name 
TOTAL/UNITS. 
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As  the  utility  executes  it  accomplishes  the  following  functions: 

o  Assigns  the  logical  unit  88  to  the  study's  general  file,  in  the  current 
example  SECRET*82W  ARFP88,  and  requires  the  user  to  supply  the 
appropriate  password  to  gain  access  to  it  prior  to  using  the 
runstream. 

o  Assigns  logical  unit  7  to  the  current  posture  array  file  being  used. 
This  file  will  contain  the  unit  identification  data  for  this  particular 
posture.  The  file  name  must  be  changed  from  run  to  run  to  reflect 
the  proper  posture  being  used.  In  this  example,  the  file  name  is 
94STOREA. 

o  Assigns  logical  unit  7  to  the  RAM/MATRIX  input  file. 

o  Assigns  logical  units  9  and  10  as  output  files. 

o  Executes  the  utility. 

o  Copies  the  contents  of  logical  unit  10  to  the  permanent  file 
TOTAL/UN ITS-XX.  The  "XX"  portion  of  this  file  name  must  be 
changed  on  each  running  of  the  utility  to  reflect  the  appropriate 
posture. 


Appropriate  replacements  for  XX  are: 


Posture  ID 
AT 
D1 
DE 
DL 


Description 

-  Attack  posture 

-  Defense  Intense  (Defend)  posture 

-  Delay  posture 

-  Defense  Light  (Inactive)  posture 


This  output  file  will  be  cataloged  under  the  current  study's  general  file. 


o  Copies  the  contents  of  logical  unit  9  to  the  permanent  file 
MISSF.D/UNITS-XX.  Once  again  the  XX  position  must  be  replaced 
on  each  run  using  the  appropriate  2  character  posture  ID. 


o  Releases  the  resources  allocated  for  this  run. 


INPUT  -  This  utility  will  be  run  four  times;  once  for  each  of  the  four 
stylized  posture  arrays  that  are  used  in  the  study.  Each  run  of  the  util¬ 
ity  will  use  the  RAM/MATRIX  file  and  one  of  the  four  posture  array 
files.  These  files  will  be  categorized  as  elements  under  the  current 
study's  general  file.  The  RAM/MATRIX  file  will  use  RAM/MATRIX  as 
its  element  name;  the  element  name  of  the  four  posture  files  must  be 
obtained  from  the  RAM  analyst. 


The  RAM/MATRIX  file  is  produced  by  the  RAM/MATRIX  utility  which 
was  completed  earlier.  The  purpose  of  the  file  is  to  identify  all  units  by 
unit  type  participating  in  the  study  arrays  and  specify  for  each  of  the  22 


artillery  vulnerability  categories  in  the  study,  the  total  number  of  units 
of  equipment  which  were  grouped  into  each  vulnerability  category.  The 
present  utility  concentrates  on  the  unit  type  portion  of  the  record  and 
ignores  the  vulnerability  category  portion. 

The  second  input  file  used  by  this  utility  is  one  of  the  stylized  posture 
array  files.  This  file  is  supplied  by  the  RAM  analyst  who  also  should  be 
contacted  for  the  proper  element  name.  This  file  is  simply  a  listing  of 
array  units  which  includes  the  four  character  unit  type  codes  which 
identify  the  unit  types  which  can  be  found  in  this  particular  battle  pos¬ 
ture  in  the  study. 

Figure  III. 12.3  depicts  the  data  example  for  the  RAM/MATRIX  files. 
Figure  111.12.4  despicts  the  example  for  the  stylized  posture  array  file. 

FILE:  ARRAYED  LIST  OF  UNITS  BY  POSTURE  (94STOREA) 

STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  RAM  ANALYST 

RECORD  FORMAT: 

Position  Description  Format 

1  -  70  Blanks  70X 

71-74  Unit  Type  Code  with  the  A4 

Posture  Array 

FILE:  RAM/MATRIX 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  Utility  -  RAM/MATRIX 

RECORD  FORMAT: 


Position  Description  Format 

1  Blank  IX 

2-3  First  2  characters  of  the  Unit  A2 

Unit  Type  Code 

4-5  Subscript  of  the  above  Code  12 

6-93  Accumulated  Quantities  for  2214 

Lincodes  and  their  corresponding 
Vulnerability  Categories. 


12.6 


OUTPUTS  -  This  utility  produces  two  mass  storage  files  as  output  for 
each  of  the  four  stylized  arrays.  One  details  those  unit  types  which 
were  expected  to  be  in  a  particular  posture  as  stated  on  the  posture 
array  input  file  but  were  not  detected  on  the  RAM/MATRIX  file.  This 
file  is  referred  to  as  the  MISSED/UNITS-XX  file.  The  XX  portion  of  the 
element  name  must  be  changed  to  reflect  the  appropriate  posture  being 
analyzed  in  this  run;  i.e.,  AT,  Dl,  DE,  or  DL.  This  file  uses  one  record 
type  consisting  of  one  four  character  field,  the  Unit  Type  Code  ID.  The 
second  output  file  of  this  utility  is  the  TOTAL/UNITS-XX  file.  This  is 
the  major  output  from  this  utility.  Once  again  the  XX  portion  of  the 
file  name  must  be  changed  to  reflect  the  posture  being  analyzed.  This 
file  consists  of  one  record  type.  Each  record  is  composed  of  2  fields. 
The  first  field  is  the  four  character  unit  type  code  identifier.  The 
second  field  in  the  record  is  a  four  character  integer  number  which 
denotes  the  total  number  of  this  particular  unit  type  that  was  found  in 
the  RAM/MATRIX. 

For  example,  line  1  of  Figure  III.  12.6,  (the  data  example  of  the 
TOTAL/UNITS  file),  indicates  that  there  were  2  units  in  the  RAM/- 
MATRIX  file  for  UNIT  TYPE  L197  in  the  particular  posture  array. 

The  file  is  cataloged  as  an  element  under  the  current  study's  general 
file. 

Figure  111.12.5  presents  examples  of  the  data  for  the  M1SSED/UNITS-XX 
file.  Figure  III.  12.6  portrays  the  data  example  for  the  TOTAL/UNITS- 
XX  file.  Figure  III .  1 2.6 A  depicts  the  sample  output  when  the  alternate 
program  is  used. 

FILE:  VHSSED/UNITS-XX 

STOR  AGE  MEDIUM:  Mass  Storage 

SOURCE:  UTILITY  -  TOTAL/UNITS 

RECO RD  FORMAT: 

Position  Description  Format 

1  -  A  Unit  Type  Codes  from  Stylized  A4 

Array  for  which  no  match  was  found 
in  the  RAM/MATRIX  file. 
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FILE:  TOTAL/UNITS  -  XX 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  UTILITY  -  TOTAL/UNITS 

RECORD  FORMAT: 


Position 


Description 


Format 


1  -  4 
5  -  6 
7  -  10 


Unit  Type  Code  A  4 

Blanks  2X 

Total  Number  of  Units  for  14 

this  Unit  Type  in  this  posture. 


PERFORMANCE  -  This  utility  will  require  the  following  resources: 


CORE: 

CPU  TIME: 
CLOCK  TIME: 
DISK  UNITS: 
COMMENTS: 


10K  OR  LESS 
2  MIN  OR  LESS 
10  MIN  OR  LESS 
1  -  2 
NONE 
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CHAPTER  13 


UTILITY  -  TOTAL/CATEGORY 
AND  WIMP  TOTAL-CAT 

13.1  DESCRIPTION:  The  purpose  of  this  utility  is  to  produce  the  total 

authorized  quantity  of  equipment  for  each  of  the  22  artillery  vulnera¬ 
bility  categories  found  in  one  of  the  four  stylized  posture  arrays.  The 
new  program,  WIMP/TOTAL-CAT  may  be  applied  in  lieu  of  this  pro¬ 
gram.  In  accomplishing  this  function  the  utility  is  run  once  for  <Mcn  of 
the  posture  arrays  using  the  RAM/MATRIX  file  and  the  appropriate 
TOTAL/UNIT-XX  file.  The  utility  will  first  multiply  the  total  number 
of  units  in  a  unit  type  as  specified  in  the  TOTAL/UNIT-XX  file  by  the 
number  of  items  of  equipment  in  a  particular  vulnerability  category  as 
specified  in  the  RAM/MATRIX  file.  The  final  step  in  this  process  is  to 
determine  the  total  number  of  items  of  equipmentin  each  of  the  22  vul¬ 
nerability  categories  by  summing  each  of  the  categories  across  all  unit 
types.  The  result  will  be  an  array,  22  entries  in  length,  one  entry  for 
each  artillery  vulnerability  category  and  the  total  number  of  items  of 
equipment  authorized  for  that  category  for  a  specific  posture. 

13.2  STRUCTURE  -  Figure  III.  13.1  depicts  the  overall  structure  of  the 
utility. 

13.3  DATA  BASE  -  The  data  base  that  is  used  to  support  this  utility  consists 
oH wo  types  of  input  files  and  one  type  of  output  file.  The  input  files 
are  the  RAM/MATRIX  and  the  four  TOTAL/UNITS-XX  files.  The  out¬ 
put  file  will  be  one  of  the  four  TOTAL/C  \TEGORY-XX  files.  This  util¬ 
ity  as  the  previous  TOTAL/UNITS  utility,  must  run  four  times,  once  for 
each  posture.  Each  run  of  the  utility  will  produce  a 
TOTAL/CATEGORY-XX  output  file. 

All  files  will  be  maintained  on  mass  storage  devices  and  be  cataloged 
under  the  study's  general  program  file. 

13.4  Rl  INSTREAM  -  Figure  III.  1 3.2  depicts  the  runstream  which  currently 
controls  the  execution  of  this  utility.  The  runstream  is  cataloged  as  an 
element  under  the  file  CSTART*S2XQT  using  element  name:  TOTAL/- 
CATEGORY.  The  alternate  utility  is  controlled  by  the  runstream  in 
Figure  IH.I3.2A.  As  the  runstream  executes  it  will  accomplish  the  fol¬ 
lowing  functions: 

o  Assign  to  the  logical  unit  88  the  current  study's  general  file;  in  this 
example  SECRET*82WARFP88.  It  further  requires  the  user  to  sup¬ 
ply  the  proper  password  to  gain  access  to  the  file. 

o  Assigns  logical  unit  7  the  RAM/MATRIX  file  and  to  logical  unit  8 
the  TOTAL/UNIT-XX  file.  As  is  always  the  case,  the  "XX"  portion 
of  the  TOTAL/UNITS  file  name  must  be  changed  to  reflect  the 
appropriate  posture  being  analyzed. 


o  Assigns  logical  unit  9  to  be  used  as  an  output  file, 
o  Executes  the  utility. 

o  Copies  of  the  results  of  the  utility  collected  in  logical  unit  9  to  the 
permanent  file  TOTAL/CATEGOR1ES-XX.  The  "XX"  portion  of 
this  file  name  must  also  be  changed  to  reflect  the  proper  posture 
being  analyzed. 

o  Releases  the  allocated  resources. 

13.5  INPUT  -  There  are  two  input  files  required  to  run  this  utility.  Both  files 
will  be  cataloged  as  elements  under  the  general  file  for  the  current 
study.  The  first  file  is  the  RAM/MATRIX.  This  file  details  for  each 
type  of  unit  in  the  study  the  number  of  items  of  equipment  that  the  unit 
has  been  authorized  classified  in  the  22  EQUIPMENT/ARTILLERY  vul¬ 
nerability  categories.  The  second  file  used  as  input  will  be  one  of  the 
TOT AL/UN1T-XX  files.  This  file  will  denote  the  total  number  of  unit 
types  found  in  the  particular  posture  array. 

Figure  111.13.3  depicts  the  RAM/MATRIX  file  example  data.  Figure 
111.13.4  depicts  the  data  example  for  the  TOTAL/UN1TS-XX  file. 

FILE:  RAM/MATRIX 

STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  Utility  -  RAM/MATRIX 

RECORD  FORMAT: 


Position 


Description 


Format 


1 

2  -  3 

4  -  5 
6  -  93 


Blank 

First  2  characters  of  the 
Unit  Type  Code 

Subscript  of  the  above  Code 

Accumulated  Quantities  for 
Lincodes  and  their  corresponding 
Vulnerability  Categories. 


IX 

A2 

12 

2214 


1  50 


FILE;  TOTAL/UNITS  -  XX 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE;  UTILITY  -  TOTAL/UNITS 

RECORD  FORMAT: 


Position 

Description 

Format 

1  -  4 

Unit  Type  Code 

A4 

5  -  6 

Blanks 

2X 

-  10 

Total  Number  of  units  for  this 

Unit  Type  in  this  posture. 

14 

OUTPUT  -  The  TOTAL/CATEGORY-XX  file  is  the  only  output 
file  from  each  run  of  this  utility.  As  with  the  TOTAL/UNITS  util¬ 
ity,  the  TOTAL/CATEGORY  utility  must  be  run  four  times;  once 
for  each  of  the  four  posture  arrays  of  the  study. 

The  output  file  will  have  one  record  type  and  22  records;  one  for 
each  of  the  22  artillery  vulnerability  categories  of  the  study. 
Each  record  will  consist  of  one  seven-digit  integer  field.  This 
field  will  contain  the  total  number  of  items  of  equipment  found  in 
a  specific  posture  array  for  a  single  vulnerability  category.  For 
example,  in  Figure  13.8  line  5  indicates  that  4,060  items  of  equip¬ 
ment  are  being  played  in  this  posture  which  have  been  assigned  an 
artillery  vulnerability  category  of  5. 

These  22  totals  in  this  posture  will  become  the  denominators  of 
the  equation  which  will  be  used  to  determine  the  WARFRAIM  loss 
rates  within  a  posture's  stylized  array.  The  RAM(WARF)  simula¬ 
tion  runs  for  each  posture  will  provide  the  number  of  equipment 
items  lost  by  vulnerability  category.  These  figures  will  be  used  as 
the  numerators  in  the  equation.  These  loss  rates  will  be  manually 
computed  and  entered  into  the  element  "CONTROL/TEMP"  of  the 
current  study's  general  file  and  be  used  as  an  input  file  to  a  subse¬ 
quent  utility. 

Figures  III. 13. 5  and  lll.I3.5A  present  the  data  example  for  the 
TOTAL/CATEGORY-XX  file. 


FILE:  TOTAL/CATEGORY  =  AT,  DE,  Dl,  DL 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  UTILITY  -  TOTAL/CATEGORY 

RECORD  FORMAT: 


Position 

Description 

Format 

l  -  7 

Quantity  Totals  for  each  of  the 

22  Vulnerability  Categories 

17 

13.7 

PERFORMANCE  -  This  utility  will  require  the  following  system 
resources  to  be  allocated: 

CORE: 

CPU  TIME: 
CLOCK  TIME: 
DISK  UNITS: 
COMMENTS: 

10K  OR  LESS 

5  MIN  OR  LESS 

10  MIN  OR  LESS 

1  -  2 

NONE 

I  52 


TOTAL/CATEGORIES  STRUCTURE 


The  WIMP/MATRIX  program  may  be  named  in  lieu  of  RAM/MATRIX 


un r i.  ar, r.: r;  cd  •  •  *r  il f  na Mr  :c gt  ap t •  82  xgt  element  name: total/category***unclassific 


38  .#  Sf  CRTT  *8  2W  ARFPR8  . 

»  A  33/  / 

•  T  7. 

38  •RAM/MATRI  X*  7. 

»n  t he  above  r  it  k  vt  r  :l 
i  n  tctal  a  jt  Hf  r:  ;r  °  rcu: 

r  M  VULNERABILITY  r  A  T  E  C  CR 

»  T  3. 

93  .TOT  AL  /UN T  TE-A  T»  3. 

►  N  T  nf  A  11 0  V  E  F  t.f.  «r  NT  F 
|N  TOTAL  NUMBER  Cr  UMTr, 
-N  S  T  Y  L  T  7  F  "  AP  RA  Y.  TH  Ir, 
i  N  TO  EXECUTION  OF  THIS 

*  N  r CO  TURFS. 
t  T  3. 

»A  3  0  X  T  . 

3?  XOT.  TC  TAL/CA  TF '  CRY 
0.  »  B  8  •  TO  TAL/CA TE  GOPY-AT 


iN  TH:  A  ROVE  F  LF  Mr  NT  F  TL 
►  N  CUT  RUT  OAT  A  FROM  THIS 
iN  THIS  r  L  r  M  F  N  T  NAME  MUS 
»N  THE  UTILITY  FOP  THE  T 


r  "R  Av/^ATPI  X"  C  ON  r  A  IN'*,  THE. 

fur  NT  FOP  TACM  CF  THE  22  ARTILLERY 

IE  G  RY  TYPE  UNIT. 


F  " T  CT AL /UN  I  TF - A T  •  CONTAINS  T^r 
FOUNT  IN  THC  ATTACK  Pr^TUr?r*r: 

ELEMENT  NAME  V  U  0  T  BE  CHANGED  PRIOR 
UTILITY  ETR  THE  OTHER  THREE  REMAINING 


E  *  T  CT  Al /c  A  T  1-0  rR  Y  -  AT  "  CONTAINS  THE 
UTILITY  TCR  THE  A  T  t  a  C  K  POSTURE. 

T  RE  C  H  A  N  E  E  D  FOP  PPICP  TO  EXECUTION  OF 
HREE  REMAINING  POSTURE  G  • 


Figure  III-  I  3-2 


UNCI  ASSIFI£0*«»F  ILE  NAME  :START*82G0  ELEMENT  N  AME  :  W  1  HP/ TO  TAL  -CA  T  ***UNCL  A  SSI  F  IED 

1  : 3 u 5 r  P8.  ,82STuOY. 

2  :  s  A  S  r. ,  A  88. 

HiASE.T  7. 

«  :if  0  88.RAM/MATRIX.7. 

8:r«IT 

F.:8"SO,N  THE  ABOVE  ELEMENT  ”R  A  M/M  TR  I  X"  CONTAINS  THE  TOTAL 
7:aHSr,N  aUThI?EO  ECIPMENT  ECR  EACH  OF  THE  22  EQUIPMENT 

8:SNsr-,N  artillert  vulnerability  categories  by  type  unit. 

•HiASC-.T  8. 

irsaco  pa.w imp/to tal -uni  is -xx.e. 

II  .'EXIT 

12:SMSC,N  THE  above  ELEhENI  "W I  HP/ To T AL -UNI TS 'XX ”  CONTAINS 
13:. MSG, N  THE  TOTAL  NUMBER  OF  UNITS  FOUND  IN  ThE  STYLI2ED 
1V:3MSE,n  POSTURE  ARRAY.  The  PORTION  "XX”  OF  THE  ELEMENT 
IS:S*SG,N  NAPE  MUST  eE  CHANGEO  TO  REFLECT  THE  APPROPRIATE 
I8:SMSr-,N  POSTURE  HE.  AT,  01,  OE  OR  OL  I . 

I7:SAsr,T  9. 

I8:aASG,A  8 2  V  I MP  . 

1  9 : a  X  Q  T  82HIMP.WIMP/ TOTAL-CAT 
70  : 2  E  D  9., 88. WIMP /TOTAL -CAT -XX 
21 :LNP 

22  :E  X  I  T 

2  3 :SMSG ,N  THE  ABOVE  E1EMENI  "WIMP/TOTAL -CAT  -XX"  CONTAINS  THE 
2M  :9M  Sf-  ,N  OUTPUT  DAT*  FRO"  THIS  UTILITY.  THE  "XX"  PORTION  OF 
28 :8MSr ,N  THE  ELEMENT  NAME  MUST  CHANGED  TO  REFLECT  THE 
26:S"Sr-,N  APPROPRIATE  POSTURE  IIE.  AT,  DI  ,  DE  OR  OL ) . 

77:c'FRrE  7. 

28:afKft  8. 

29  :9F  REE  9. 

30:SFREE  88. 


Figure  III.  1 3.2A 


.  M  »  I  LT  ••  *1  X*  wpLf  «  r  TMf  OUTf  LT  DATA  Of  UTILITY  uN'tL.  A'‘j*rIfD 


*>01 

0 

p 

n 

2  7 

c 

24 

n 

0 

0 

0 

0 

0 

1  71 

17 

“7 

24 

T  3 

1 

0 

0 

9 

:  n  o  ,* 

0 

u 

4 

66 

0 

66 

0 

20 

10 

0 

0 

4  1147 

79 

7  1  r 

771 

ini 

147 

7t 

0 

15 

f  N03 

c 

0 

c 

.’4 

32 

r 

24 

0 

7 

2 

0 

c 

4 

70? 

9 

55 

71 

43 

11 

7 

0 

15 

:  04 

c 

0 

G 

5 

*3 

c 

1  2 

c 

2 

2 

0 

0 

0 

1  94 

15 

51 

36 

9 

70 

4 

0 

C 

1  *.  05 

c 

c 

4 

11 

20 

c 

l  4 

c 

5 

G 

c 

0 

r. 

lc0 

b 

5L 

56 

22 

16 

3 

0 

c 

r«0l 

0 

c 

C 

'T 

14 

G 

1  7 

c 

2 

Q 

c 

c 

0 

215 

1C 

53 

131 

77 

25 

1 

0 

0 

‘  A  C7 

0 

16 

0 

4.3 

79 

1 i 

2  4 

0 

5 

0 

? 

r  4 

7 

r  45 

74 

1  7( 

.7  56 

79 

118 

3 

0 

0 

f  A  0* 

0 

0 

c 

79 

3 

L 

1  5 

c 

1 

G 

c 

0 

G 

?  4  C 

17 

c  « 

274 

4  3 

73 

7 

0 

c 

t  A  [V* 

0 

f 

0 

» 

f 

C 

2 

G 

1 

G 

0 

15 

0 

1C8 

17 

22 

74 

8 

13 

0 

0 

c 

«  A  10 

0 

0 

c 

1  9 

C 

5 

c 

1 

G 

2 

9 

7 

31 

6 

19 

20 

11 

6 

1 

0 

0 

r  A  1  2 

C 

n 

G 

r  •» 

r-4 

c 

77 

c 

21 

1 

2 

48 

t! 

76  7 

a? 

170 

4  1 L 

115 

106 

7 

0 

0 

'A 12 

c 

i 

c 

'.4 

4 

G 

1  5 

0 

1 

0 

0 

0 

D 

2  34 

70 

Cl 

274 

53 

5  8 

1 

0 

0 

ran 

c 

4 

c 

4 

B 

C 

3 

0 

1 

G 

0 

1? 

0 

105 

14 

21 

37 

8 

10 

1 

0 

c 

r  a  m 

Q 

r> 

c 

7 

7 

0 

4 

c 

1 

0 

0 

0 

G 

64 

11 

7C 

S3 

?5 

11 

1 

0 

c 

f  A  IT. 

0 

0 

0 

L 

2  3 

G 

O 

0 

16 

1 

2 

12 

0 

1  *4 

3 

70 

23 

13 

7 

2 

0 

c 

FA  It 

l' 

12 

L 

42 

42 

0 

28 

0 

5 

1 

? 

42 

G 

c  u<4 

57 

123 

210 

53 

64 

1 

0 

0 

f  A  !  7 

L 

D 

G 

.’7 

3 

c 

16 

G 

1 

0 

0 

0 

0 

145 

11 

41 

93 

19 

21 

0 

0 

c 

f  A  1ft 

c 

4 

C 

3 

7 

c 

Z 

0 

1 

0 

c 

11 

c 

104 

13 

22 

32 

8 

12 

0 

0 

c 

f  a 

c 

o 

C 

I 

1  8 

G 

6 

0 

1 

1 

7 

9 

0 

97 

7 

It 

21 

10 

7 

1 

0 

c 

f  A 

0 

TO 

c 

7fc 

74 

L 

4Q 

0 

5  8 

G 

2 

0 

0 

7  42 

19 

62 

321 

ini 

23 

1 

0 

0 

*  a  ?i 

0 

0 

c 

’4 

11 

C 

19 

c 

1 

0 

2 

0 

o 

125 

4 

13 

75 

°C 

14 

1 

0 

c 

f  A  V 

c 

1C 

c 

16 

21 

C 

7 

0 

19 

0 

0 

0 

0 

1  79 

5 

21 

82 

25 

3 

0 

0 

0 

c 

IT 

c 

34 

71 

0 

46 

G 

5 

0 

6 

p 

2 

97b 

142 

459 

452 

43 

87 

3 

0 

0 

’4 

0 

D 

c 

14 

23 

c 

19 

0 

5 

0 

2 

0 

2 

1  94 

21 

43 

74 

29 

15 

3 

0 

0 

f^r  'r, 

0 

7 

G 

.3 

2 

c 

5 

0 

0 

c 

1 

0 

0 

209 

35 

3  3 

95 

3 

12 

0 

0 

0 

M'  -»k 

0 

1 

G 

1 

0 

0 

1 

0 

0 

G 

0 

0 

n 

f  8 

11 

70 

28 

0 

2 

0 

0 

c 

’7 

c 

4 

C 

11 

2 

G 

12 

0 

0 

G 

1 

p 

n 

lc  8 

1C 

1  77 

93 

c 

7G 

0 

0 

0 

V-  >Q 

c 

C 

C 

;  O 

35 

C 

c9 

0 

8 

D 

0 

0 

c 

400 

0 

59 

60 

50 

It 

4 

0 

c 

v'  -.3 

0 

c 

( 

?  7 

14 

L 

29 

0 

2 

0 

0 

n 

c 

1  r4 

D 

22 

41 

?3 

4 

1 

0 

c 

m;  to 

c 

0 

c 

1  4 

7 

C 

10 

0 

2 

C 

G 

0 

0 

92 

0 

12 

13 

9 

4 

1 

0 

r 

►*:  ’i 

c 

G 

L 

6 

21 

0 

70 

0 

2 

0 

0 

0 

0 

1  2b 

0 

lb 

34 

16 

2 

62 

0 

1 

Mr.  ’z 

c 

U 

C 

45 

2 

0 

6 

0 

1 

G 

0 

0 

0 

102 

0 

15 

22 

13 

3 

0 

0 

c 

□ 

c 

G 

9 

9 

0 

1  7 

0 

2 

G 

a 

0 

0 

130 

0 

7? 

2  41 

T4 

57 

2 

0 

0 

r  »M 

0 

0 

C 

3 

40 

0 

13 

0 

6 

0 

G 

0 

p 

261 

4 

21 

53 

25 

5 

4 

0 

c 

v. 

0 

G 

G 

1  1 

43 

c 

26 

0 

3 

0 

G 

0 

c 

139 

12 

17 

59 

It 

10 

0 

0 

c 

»r 

0 

C 

C 

2 

75 

c 

20 

0 

13 

0 

0 

0 

1 

171 

9 

47 

44 

23 

3 

8 

0 

0 

A-  '7 

G 

0 

G 

:  i 

23 

G 

10 

G 

3 

G 

0 

0 

0 

129 

4 

14 

38 

13 

1 

7 

0 

0 

*•: 

[• 

0 

r 

:i 

17 

c 

16 

0 

6 

0 

0 

0 

0 

113 

3 

12 

44 

T0 

2 

11 

0 

Q 

,v  »1 

0 

0 

r 

9 

14 

0 

IZ 

0 

6 

G 

0 

0 

0 

179 

4 

12 

10 

10 

4 

0 

6 

c 

4  c 

0 

0 

G 

:  i 

24 

n 

1  3 

0 

r 

0 

0 

0 

c 

197 

7 

99 

1 8 

5 

2 

2 

c 

'>'■  4  I 

0 

c 

C 

i  •  ? 

4*; 

c 

r.  9 

0 

4 

0 

0 

0 

c 

709 

10 

£3 

952 

1  99 

f  98 

o 

0 

c 

*.r  42 

0 

0 

G 

1  .7 

18 

c 

1  9 

0 

1 

D 

0 

0 

c 

1  C4 

1 

17 

109 

24 

3 

9 

0 

c 

'■/  43 

0 

0 

C 

r.r 

10 

p 

1  7 

c 

1 

0 

0 

0 

p 

7  74 

4 

It 

252 

60 

224 

0 

0 

Q 

'.C  4  4 

0 

0 

G 

47 

5 

c 

8 

c 

1 

0 

0 

0 

c 

1  9? 

4 

15 

217 

45 

1  32 

Q 

0 

n 

4  5 

G 

G 

G 

c.c 

12 

G 

1  5 

0 

1 

0 

0 

0 

0 

1  99 

1 

15 

274 

r0 

3  39 

0 

0 

c 

AT  4fj 

0 

c 

G 

7 

4 

C 

8 

0 

2 

u 

0 

0 

c 

29? 

4 

7 

17 

7 

2 

1 

0 

c 

('47 

C 

0 

C 

2 

2 

0 

3 

0 

0 

0 

G 

0 

G 

34 

7 

7 

13 

t 

1 

0 

0 

c 

At-’  4H 

0 

0 

G 

70 

t( 

G 

27 

0 

1 

0 

0 

0 

c 

m 

4 

23 

60 

29 

1 

2 

0 

r 

a;  u  > 

0 

4 

4  4 

77 

G 

4  7 

0 

5 

5 

2 

n 

ft 

£94 

24 

249 

786 

up 

C  9 

3 

0 

c 

A '  •  C 

G 

G 

L 

20 

79 

0 

75 

0 

5 

2 

1 

0 

0 

1  ^2 

2 

45 

ini 

»7 

16 

3 

0 

c 

a;.  r  i 

L 

0 

C> 

*: 

2 

G 

4 

0 

0 

1 

0 

0 

p 

129 

1 

40 

39 

4 

9 

0 

0 

c 

A :  ' 

U 

0 

r 

1 

0 

0 

0 

0 

0 

0 

0 

0 

c 

4? 

P 

1C 

8 

0 

2 

0 

0 

c 

A  •  r  » 

c 

4 

? 

3 

2 

0 

10 

0 

0 

0 

1 

0 

G 

107 

13 

64 

68 

4 

26 

0 

0 

c 

"  A  r  4 

C 

c 

G 

19 

4 

c 

14 

0 

1 

0 

1 

c 

G 

107 

6 

19 

67 

?t 

3 

z 

0 

0 

c  a  5  5 

G 

9 

G 

44 

46 

c 

4  3 

G 

6 

3 

2 

2 

71P79 

103 

540 

5  06 

7p 

133 

6 

2 

? 

FA  r L 

0 

c 

G 

26 

24 

G 

19 

0 

5 

G 

2 

0 

3 

208 

79 

47 

99 

27 

23 

3 

0 

c 

r& r'  7 

r 

0 

C 

t 

16 

c 

1  5 

0 

1 

0 

0 

7 

0 

7  **£ 

1  l 

107 

198 

19 

64 

3 

2 

c 

Figure  HI. 1 3.3 


1  56 


UNClASSiriEO«»*EXAMPLE  OE  OUTPUT  OP  UTILITY  TO  TAL/UN  IT  S»  »«  UNCLASSI FIEO 


i  :l:9 7 

2 

2  :l  19  9 

1 

3  :l  2 a  i 

1 

4  :i  ?a  2 

1 

6  :L  38  3 

1 

6  :l?a  3 

1 

7  :t427 

4 

8  :scs  1 

1 

9:scs3 

1 

inrscs? 

1 

11  ISC5  3 

1 

i2:sce.  u 

1 

13  :SC5  5 

1 

14  :SC56 

1 

1*  !SC3  5 

4 

16  :SC76 

4 

1 7  :  S  C.3  7 

5 

18  :SC3  3 

4 

1*3  :t  bi  l 

7 

20  :t  ci  i 

28 

21  :tpi  i 

84 

22  :mfi 6 

4 

23  :mci  7 

8 

24  .'MCI  7 

24 

28  :hti  7 

8 

26  :RCD  6 

8 

2  7  J  R  33  9 

4 

29  :ML3  4 

4 

23  :MP3  4 

12 

30:*I3  4 

4 

31  :ML7  2 

1 

32  :il9  3 

1 

33  :l  207 

4 

34  :A  H4  7 

1 

33  :AP4  7 

2 

36  :A  T 4  7 

2 

37  !AD7  3 

1 

39  !A  D80 

1 

39  :A  DS  1 

2 

40  :  A  VI  1 

4 

41  :l  29  1 

1 

4?  :c  P4  i 

1 

43  :L  49  2 

8 

44 :c  $9  3 

1 

48  !L49  4 

1 

46 :L  49  5 

1 

47 :i 49  6 

l 

48  :msi  2 

4 

49 :M  61  3 

4 

90  :m  61 4 

4 

51 : m  s i s 

4 

82  :p  W3  3 

4 

5  3  :  C  H3  0 

4 

54  :c  H5  9 

1 

65  :c  Mf,  0 

1 

5C  :  C  H6  9 

1 

5  7  :  A  D4  6 

2 

Figure  HI.  13.4 


UNCLASSIFIED*. .EXAMPLE  OF  OUTPUT  OF  UTILITY  TOTAL/CATEGORY 


i : 

0 

2 : 

166 

3 : 

0 

4 : 

34  57 

s  : 

40  6U 

6 : 

U 

7 : 

13  33 

e : 

3  42 

9 : 

2  59 

10 : 

5U 

n : 

28 

12 : 

253 

13 : 

71 

14 : 

30  93 

15 : 

42  96 

16 : 

8  55 

17: 

36  67 

18 : 

1049 

19 : 

7  84  83 

20 : 

750 

21 : 

U 

22 : 

3 

Figure  HI. 13.5 


v 


I  NCliSSIF  irO-^LXAMPLr  .F  The  OUTPUT  Li  4  T  8  OP  UTILITY  WIMP/ 


A 


^  : 

j  3t> 

_j  : 

25  1 

4  : 

i; 

L  • 

i::?  l 

c  : 

718 

7  : 

a 

t  : 

95  2 

9  : 

b 

1 L : 

lru 

1 1  : 

?  a 

IP: 

37 

1  o : 

17b 

1  h  : 

ir  j 

I  5  : 

2  r  3  1  6 

1  b  : 

2  9  14 

1  7 : 

1^142 

It. : 

l  4  1-:  1 

19: 

1  7  3  6 

2  u : 

7  c  7  5 

2  1  : 

9  1 

: 

5  7 

?j: 

a 

Figure  III.  1  3. 5 \ 


t  59 


L 


CHAPTER  14 


UTILITY  -  SE ARCH/ENG AGEREP 

14.1  DESCRIPTION  -  The  purpose  of  this  utility  is  to  determine  the  fraction 
of  time  spent  by  the  U.S.  Force  in  each  of  the  four  combat  postures  in 
each  of  the  seven  time  periods  of  the  study.  The  8  combat  postures 
played  bv  the  CEM  are  converted  to  the  4  played  by  the  MPP.  The  four 
combat  postures  are  Attack,  Defense  Intense  (Defend),  Delay  and 
Defense  Light  (Inactive).  The  seven  time  periods  of  the  study  are 

PERIODS 

1  2  3  4  5  6  7 

DAYS  1-15  16-30  31-60  61-90  91-120  121-150  151-180 

In  order  to  determine  this  fraction  of  time  the  utility  uses  as  its  only 
input,  the  Engagement  Report  which  was  produced  by  the  Concepts 
Evaluation  Model  (CEM)  theater  simulator.  This  file  may  either  be 
found  on  magentic  tape  or  on  mass  storage.  Depending  on  the  location 
of  the  file,  a  different  runstream  will  be  used  to  execute  the  utility. 

The  output  from  this  utility  will  be  a  mass  storage  file  "SCEN ARIO-XX" 
which  will  be  used  as  input  to  the  following  utility, 
"CONTROL/COMPILER." 

14.2  STRUCTURE  -  Figure  III.  14.1  presents  the  overall  structure  of  this 
utility, 

14.3  DATA  BASE  -  The  data  base  which  is  used  to  support  this  utility 
consists  of  two  files;  one  input  file  and  one  output  file.  The  input  file  is 
the  Engagement  Report  which  was  produced  by  the  CEM.  This  file 
details  the  amount  of  time  spent  by  allied  forces  in  various  combat 
missions  during  various  time  periods  of  the  conflict.  It  should  be 
emphasized  that  this  file  contains  data  not  only  on  U.S.  forces;  but  also 
NATO  and  other  non-!  LS.  forces.  The  output  portion  of  the  data  base 
from  this  utility  is  the  SCENARIO/XX  file.  This  file  presents  summary 
for  the  U.S.  forc  es,  for  the  seven  time  periods  of  the  study,  the  percent 
of  the  time  the  l  l.S.  force  spent  in  one  of  the  four  combat  postures; 
i.e.c,  Attack,  Defend,  Delay  or  Inactive.  This  file  will  serve  as  one  of 
the  five  input  files  to  the  following  utility,  "CONTROL/COMPILER." 

14.4  RUNSTREAM  -  This  utility  is  different  from  others  in  that  it  has  two 
runstreams  that  can  he  exec  uted  depending  on  whether  or  not  the  input 
file  for  the  utility,  ENGAGEREP,  is  artiveon  the  public  mass  storage 
device  or  has  heen  mac  ti voted  and  placed  on  magnetic  tape. 

If  the  ENGAGEREP  file  is  active  and  resident  on  the  public  pack  the 
runstream  under  the  element  name  SEARCH/ENG  AGEREP- 1  (Figure 
III.  14.2)  is  executed.  If  the  file  is  inactive  and  resides  on  magnetic  tape 
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then  the  runstream  SEARCH/ENGAGEREP-2,  Figure  III.14.2A,  must  be 
executed.  In  either  case,  both  runstreams  are  cataloged  under  the 
program  file  name  CSTART*82XQT. 

As  these  runstreams  execute  they  perform  the  following  functions: 

o  Allocate  to  logical  unit  88  the  program  file  of  the  current  study;  in 
this  instance  SECRET*82\VARFP88.  They  further  require  the  user 
to  provide  the  proper  password  to  gain  access  to  the  program  file. 

o  If  the  ENGAGEREP  is  inactive  and  on  magnetic  tape,  then  the  run- 
stream  (Figure  III.  14. 3)  will  require  the  user  to: 

Replace  the  "XXXX"  on  line  5  of  the  runstream  with  the  proper 
tape  number  of  the  GEM  output  which  can  be  obtained  from  the 
CEM  Operator/Analyst.  With  the  proper  tape  identified,  the 
runstreams  will  allocate  a  temporary  file  "82TAPE"  which  will 
facilitate  the  reading  of  the  tape. 

The  magnetic  tape  will  probably  contain  other  files  besides  the 
ENGAGEREP  file.  Therefore,  Line  12  of  the  runstream  will  instruct 
the  system  to  skip  past  the  first  "X"  number  of  files  on  the  tape  in  order 
to  position  the  tape  reader  at  the  beginning  of  the  file.  The  "X"  must 
be  replaced  by  the  proper  number  of  files  which  precede  the 
ENGAGEREP  file  on  the  tape.  This  information  also  can  be  obtained 
from  the  GEM  Operator/ Analyst. 

o  The  next  4  statements  (Lines  17-20)  will: 

Allocate  a  temporary  file  to  logical  unit  7; 

Copy  the  contents  of  ENGAGEREP  to  file  7; 

Rewind  the  tape;  and 

Release  the  temporary  file  82  tape. 

o  If  the  file  ENGAGEREP  is  active,  then  the  runstream  will  require 
the  user  to  do  nothing.  Logical  unit  7  will  be  allocated  and  the 
contents  of  the  active  file  assigned  to  it. 

o  In  either  case,  the  next  step  will  be  to  execute  the  utility. 

o  The  results  of  the  processing  will  then  be  copied  to  the  permanent 
file  SCENARIO/XX  and  cataloged  under  the  study's  program  file. 
The  "XX"  portin  of  the  element  name  must  be  changed  to  reflect 
the  ('EM  Run  Control  Number  which  can  be  obtained  from  the  CEM 
Operator /Analyst. 

o  Release  the  resources  allocated  to  this  utility. 
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1*0  INPUT  -  The  SEARCH/ENGAGEREP  utility  has  one  input  file,  the 
ENGAGEREP.  This  file  is  an  output  of  the  Concept  Evaluation  Model 
(CEM)  which  is  a  high  resolution  theater  simulation  model.  The 
ENGAGEREP  will  contain  information  on  not  only  U.S.  forces  but 
NATO  and  other  non-U. S.  forces.  Therefore,  one  of  the  functions  of 
this  utility  is  to  screen  out  all  data  which  does  not  pertain  to  the  U.S. 
force. 

The  file  is  composed  of  three  basic  record  formats.  The  first  record 
format  identifies  that  portion  of  the  total  force  and  the  particular  day 
being  analyzed.  The  second  record  format  details  the  total  time  spent 
by  the  Blue  forces  in  one  of  the  9  details  the  total  time  spent  by  the 
Blue  forces  in  on  eof  the  9  combat  missions  during  this  specific  time 
period;  i.e.,  15  days.  The  third  record  type  specifies  the  fraction  of 
time  spent  by  U.S.  forces  during  this  time  period;  i.e.  15  days.  The 
third  record  type  specifies  the  fraction  of  time  spent  by  U.S.  forces 
during  this  time  period  in  one  of  the  four  combat  postures;  i.e.,  Attack, 
Defense  Intense  (Defend),  Delay  or  Defense  Light  (Inactive). 

As  was  noted  earlier  in  paragraph  14.4,  if  the  ENGAGEREP  file  is 
currently  active,  it  will  be  found  on  the  public  mass  storage  device 
under  the  current  study's  program  file  using  the  element  name 
"ENGAGEREP."  If  the  file  has  been  inactivated.  It  can  be  found  on 
magnetic  tape.  The  proper  tape  number  and  location  on  the  tape  can  be 
obtained  from  the  CEM  Operator/ Analyst. 

The  following  give  the  record  layouts  for  the  file.  Because  of  the 
voluminous  quantity  of  the  ENGAGEREP  sample  data,  no  sample  data  is 
provided  here. 


FILE:  ENGAGEREP 

STORAGE  MEDIUM;  Mass  Storage 

SOURCE;  CEM 

RECORD  FORMAT: 


Position 


Description 


Format 


1-8 

9-14 

15-20 

21-26 

27-30 

71-74 


Blanks 

8X 

Allied  Force  ID  (1) 

A6 

Allied  Force  ID  (2) 

A6 

Allied  Force  ID  (3) 

A6 

Blank 

44X 

Number  of  the  day  of  study 

14 
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S  Blank  Records 


1-69 

Blank 

69X 

70-88 

Total  time  spent  by  Blue  Units 
attacking  Red  in  hastily  pre¬ 
pared  positions 

F  18.1 

1-69 

Blank 

69  X 

70-88 

Total  time  spent  by  Blue  Units 
attacking  Red  in  prepared  position 

F18.1 

1-69 

Blank 

69X 

70-88 

Total  time  spent  by  Blue  Units 
attacking  Red  units  in  Delay 

F  18.1 

1-69 

Blank 

69  X 

70-88 

Total  time  spent  by  Blue  Units 
in  chance  meeting  with  Red  units 

F  18.1 

1-69 

Blank 

69X 

70-88 

Total  time  spent  by  Blue  Units 
in  hastily  prepared  positions 
while  Red  attacks 

F  18.1 

1-69 

Blank 

69X 

70-88 

Total  time  spent  by  Blue  Units 
in  prepared  positions  while  Red  attacks 

F  18.1 

1-69 

Blank 

69X 

70-88 

Total  time  spent  by  Blue  Units 
in  Delay  while  Red  units  attack 

F18.1 

1-69 

Blank 

69  X 

70-88 

Total  time  spent  by  Blue  Units 
in  a  Static  State 

F18.1 

1-69 

Blank 

69X 

70-88 

Total  time  spent  by  Blue  Units 
in  Reserve 

F  18.1 

6  skipped  records 

1-95 

Blank 

95X 

96-113 

Fraction  of  the  total  time 

spent  by  Blue  Units  in  Attack  posture 

F  18.3 

1  64 


14.6 


1-95 

96-113 

1-95 

96-113 


1-95 


Blank 

Fraction  of  the  total  time 

spent  by  Blue  Units  in  Defend  posture 

Blank 

Fraction  of  the  total  time 

spent  by  Blue  Units  in  Delay  posture 

Blank 


96-1 13  Fraction  of  the  total  time 

spent  by  Blue  Units  in  Inactive  Posture 


95X 
F  18.3 

95X 
F  18.3 

95X 
F  18.3 


OUTPUT  -  This  utility  produces  one  file  as  output  called  the 
SCENARIO/XX.  THE  "XX"  portion  of  this  name  will  be  changed  to 
reflect  the  appropriate  CEM  run  control  number  as  provided  by  the 
CEM  Operator/Analyst.  The  SCENARIO/XX  file  will  be  used  as  one  of 
the  five  input  files  to  the  CONTROL/COMPILER  utility  which  follows: 


The  SCENARIO/XX  file  will  contain  information  which  describes  the 
total  time  spent  by  IJ.S.  forces  in  each  of  the  nine  combat  missions  and 
the  fraction  of  the  total  time  spent  by  U.S.  forces  in  each  of  the  nine 
combat  missions  and  the  fraction  of  the  total  time  spent  in  each  of  the 
four  combat  postures.  This  information  is  provided  for  each  of  the 
seven  time  periods  in  the  study.  (It  should  be  noted  that  the  capability 
does  exist  to  express  this  information  for  an  additional  3  time  periods.) 

The  SCENARIO/XX  file  uses  3  record  formats  to  identify  and  describe 
each  of  the  seven  basic  time  periods  in  the  study  and  the  distribution  of 
the  total  time  U.S.  forces  spent  within  each  of  the  various  nine  combat 
missions  and  the  fraction  of  the  total  time  spent  within  each  of  the  four 
combat  postures.  The  file  further  summarizes,  at  the  end  of  the  file, 
the  fraction  of  time  spent  in  each  of  the  four  combat  postures  for  ten 
time  periods. 


Figure  III.  14.4  presents  the  SCENARIO/XX  example  data  in  the  file. 


FILE:  SCENARIO/XX 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  UTILITY  -  SEARC.H/ENGAGEREP 


RECORD  FORMATS: 


Position 


1 

2  -  8 
9-12 


Description 
RECORD  A 


Blank 

•ICYCLF  -' 

Time  Cycle  Period 


Format 


IX 

14 


165 


13  22 

Blanks 

10X 

2  3  -  28 

Allied  Force  ID  (1) 

A6 

29  -  34 

Allied  Force  IF)  (2) 

A6 

35  -  40 

Allied  Force  ID  (3) 

A6 

RECORD  B* 

1  -  25 

Blanks 

25X 

26-32 

Total  amount  of  time  spent  by 

IJ.S.  units  in  a  specific  mission 

F7.1 

1  -  40 

Blank 

40X 

41  -  48 

Fraction  of  the  total  time  spent 
by  U.S.  forces  in  one  of  the  4 

Combat  postures 

F8.3 

RECORD  C** 

1 

M' 

1H1 

2  -  5 

Blanks 

4X 

6-11 

'ATTACK' 

- 

12  -  15 

Blanks 

4X 

16  -  21 

(DEFENSE  INTENSE) 

- 

22  -  26 

Blanks 

5X 

27  -  31 

'DELAY' 

- 

32  -  33 

Blanks 

2X 

34-41 

(DEFENSE  LIGHT) 

- 

RECORD  D 

1  -  10 

Blanks 

10X 

11-17 

'15  DAYS’ 

- 

This  record  will  occur  9  times;  once  for  each  of  the  9  combat  missions. 
This  record  will  occur  4  times;  once  for  each  of  the  4  combat  postures. 


1  66 


RECORD  E*** 


I 

Rlank 

IX 

2  -  41 

The  fraction  of  time  spent  by 

U.S.  forces  in  each  of  the  four 
combat  postures  in  each  of  the 
first  2  15-day  periods  of  the 
study. 

Skip  4  records 

RECORD  F 

4(F !  0.4) 

1 

Rlank 

IX 

2  -  3 

'30  days' 

- 

1 

Rlank 

IX 

2-41 

The  fraction  of  time  spent  by  U.S. 
forces  in  each  of  the  4  combat 
postures  in  each  6  30-day  periods  of 
the  study. 

Skip  4  records 

RECORD  G 

4(F  10.4) 

I 

Blank 

IX 

2  -  3 

'90  days' 

- 

1 

Rlank 

IX 

2  -  41 

The  fraction  of  time  spent  by 

1  J.S.  forces  in  each  of  the  4 
combat  postures  in  each  of  the 

2  90-day  periods  of  the  study. 

4(F10.4) 

***  This  record  will  occur  twice. 
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CHAPTER  15 
i  ftilitv  -  CEM/DATA 


DESCRIPTION  -  The  purpose  of  this  utility  is  to  produce  the  CEM/- 
DAT A  file  which  details,  time  period  by  time  period,  equipment  author¬ 
ization  levels  and  loss  rates  for  each  specific  item  equipment  type  with¬ 
in  the  four  ma]or  classifications  of  combat  equipment,  i.e.,  tanks, 
armored  personnel  carriers  (APC),  helicopters,  and  antitank/mortar 
weapons  (ATM).  This  data  is,  in  turn,  used  as  input  to  the  following 
utility,  OE.M/LOSS. 

This  utility  and  the  following  CEM/LOSS,  are  unique  within  the  Materiel 
Postprocessor  in  that  they  share  and  are  executed  from  the  same  run- 
stream,  entitled  ('EM/LOSSES,  which  is  cataloged  as  an  element  under 
the  program  file  CSTART*S2XQT.  the  output  file  from  the  CEM/DATA 
is  used  immediately  as  input  to  the  CEM/LOSSES  and  is  released 
immediately.  Only  the  output  from  CEM/LOSSES  is  permanently  cata¬ 
loged.  Therefore,  if  processing  is  interrupted  at  any  point  in  the  run¬ 
ning  of  this  series  of  utilities,  both  must  be  rerun. 

STRUCTURE  -  Figure  111.15.1  displays  the  overall  structure  of  the  util¬ 
ity. 

DATA  BASE  -  The  data  base  which  supports  this  utility  consists  of  two 
mass  storage  files,  one  serving  as  input  and  the  other  as  output.  The 
input  file  has  been  created  specifically  for  the  WARF  from  the  LOG 
Report  processor  of  the  CEM.  This  file  essentially  specifies  the  major 
items  of  equipment  in  the  study,  their  levels  of  authorization  and  loss 
rates.  Four  major  items,  (i.e.,  tanks,  APC’s,  helicoptors  and  ATM's  of 
which  individual  model  types  may  be  specified,  for  example  the  M-l 
tank. 

Using  this  file  as  its  input  the  CEM/DATA  utility  will  produce  the 
CEM/LOSSES  1  file  as  its  sole  output.  This  file  will  provide  a  period  by 
period  summary  of  the  average  authorization  levels  and  loss  percent¬ 
ages  for  each  specific  model  of  each  of  the  four  major  equipment 
types.  The  time  periods  are  here,  for  the  first  time,  broken  fnto  two 
major  categories.  The  fist  90  days  are  referred  to  as  the  INTENSIVE 
PERIOD;  the  second  90  days  are  called  the  SUSTAINING  PERIOD.  This 
file  will  be  used  as  the  sole  input  file  to  the  follwoing  utility  CEM /- 
LOSSF.S. 

Rl  INSTREAM  -  The  runstream  which  controls  the  execution  of  this  util¬ 
ity  also  controls  the  execution  of  the  following  utility  CEM/LOSSES. 
Therefore,  it  will  be  described  once.  The  runstream  is  displayed  in  Fig¬ 
ure  III.  15.2.  As  the  runstream  executes  it  accomplishes  the  following 
functions: 

o  Assigns  the  program  file  for  the  current  study  to  the  unit  88  for 
further  processing.  In  the  current  example  the  current  study's 
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program  file  is  SECRET*82ty ARF88.  It  further  requires  the  user  to 
supply  the  proper  password  to  get  access  to  the  system. 


o  Assigns  to  logical  unit  7  the  CEM  data  report,  which  was  prepared 
exclusively  for  WARE  from  the  CEM  LOG  REPORT.  In  the  current 
example  the  file  73AMP88-XX  is  used  as  this  input  file.  The  proper 
file  name  and  GEM  run  control  number,  which  replaces  the  "XX" 
portion  of  the  file  name,  must  be  obtained  from  the  CEM  OPER¬ 
ATOR/ANALYST  prior  to  the  execution  of  the  utility. 

o  Instead  of  explicitly  establishing  an  output  file  and  assigning  it  a 
logical  unit  number  as  was  done  in  previous  utilities,  this  utility 
accomplishes  much  the  same  functions  but  uses  a  different  tact.  In 
line  18  of  the  runstream  a  breakpoint  is  set,  the  PRINT  file  is  acti¬ 
vated  and  output  file  82CEMLOSS  1  is  identified.  This  action  will 
allow  the  utility  to  write  its  output  to  the  system  default  print  file, 
logical  unit  6  and  automatically  have  it  directed  to  the  interim 
file  for  temporary  storage.  All  data  written  to  the  print  file  during 
this  time  before  the  closing  Breakpoint  statement,  Line  25,  will  be 
treated  in  this  manner. 

o  The  utility  is  executed. 

o  As  the  message  in  lines  21-24  notes,  the  utility  will  read  the  num¬ 
ber  entered  in  line  20  on  columns  39-40  using  the  system  default 
logical  unit  5.  This  figure  denotes  the  number  of  4-day  theater 
cycles  that  will  be  played  in  the  current  study.  This  figure  will  also 
be  used  to  calculate  the  number  of  division  cycles,  and  corps 
cycles.  In  the  current  study  45,  4  day  (i.e.,  180  days)  increments 
are  used. 

o  Line  25  closes  the  Breakpoint. 

o  Unit  7  is  released. 

o  At  this  point  the  interim  file  CEM/LOSS  has  been  created  and  is 
immediately  assigned  to  logical  unit  7  to  be  used  as  input  to  the 
next  utility,  CEM/LOSSES. 

o  Logical  unit  8  is  assigned  as  the  output  file. 

o  The  utility  CEM/LOSSES  is  executed.  This  utility  is  cataloged  as 
an  element  under  the  program  file  82XQT. 

o  As  in  the  utility  above  this  utility  will  read  data  in  directly  from 
the  RIJNSTREAM.  These  data  elements  allow  the  user  to  identify 
and  limit  those  weapon  numbers  of  WARE  Major  Items  of  Equip¬ 
ment,  a  maximum  of  49  major  weapon  systems  may  be  identified. 

o  The  contents  of  the  logical  unit  file  8  are  copied  to  the  permanent 
file  C.EM/LOSSES-XX,  or  the  "XX"  portion  must  be  changed  by  the 
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usc'r  to  reflect  the  anpropriate  CBM  run  control  number.  This 
number  can  be  obtained  from  the  CBM  Operator/ Anal vst. 


o  Allocated  units  are  relased. 

INPI'T  -  There  is  onlv  on'*  input  file  for  this  utility.  It  is  the  CEM/- 
H AT  \  report  file  which  is  produced  exclusively  for  tlte  WARE  from  the 
CBM  I.OCi  REPORT  (LOGREP).  The  file  should  be  cataloged  as  an  ele¬ 
ment  under  the  current  study’s  program  file,  in  this  present  case 
SECRET'82W  ARES8,  using  the  element  name  GEM/DATA. 

The  file  details  the  number  of  items  of  equipment  authorized  and  the 
('EM  loss  rates  for  up  to  12  individual  models  of  four  major  items  of 
combat  equipment.  The  four  major  items  of  combat  equipment  are 
tanks,  armored  personnel  carriers  (APC),  helicopters  and  antitank  & 
mortar  weapons  (ATM).  An  example  of  one  of  the  12  individual  models 
of  one  of  these  major  combat  items  would  be  the  XM1  Model  Tank. 

The  following  details  th>  lile  layout  for  the  CEM  Data  Record  file. 

FILE:  ('EM  DATA  REPORT  (7TAMP8S-XX) 

STOP  AGE  MF.hli’M:  Mass  Storage 
SOURCE:  ‘GEM-LOG  REPORT 


RECORD  FORM  AT: 


Column 


Description 


Format 


-SO 

T  ANKS  -  Authorized  number  and 
loss  rates  for  the  first 
four  models. 

8F  1 0.4 

-80 

TANKS  -  Authorized  number  and  loss 
rates  for  the  second  four  models. 

8F10.4 

-80 

TANKS  -  Authorized  number  and  loss 
rates  for  the  final  four  models 

SF  1 0.4 

-80 

APCs  -  Authorized  number  and  loss 
rates  for  the  first  four  models. 

SF  1 0.4 

-SO 

APCs  -  Authorized  number  and  loss 
rates  tor  the  second  four  models. 

SF  1 0.4 

-SO 

APCs  -  Authorized  number  and  loss 
rates  for  the  final  four  models 

SF  1 0.4 

-SO 

HELICOPTERS  -  Authorized  number  and 
loss  rates  for  the  first  four  models 

SF  1 0.4 

-SO 

HELP' 'OPTERS  -  Authorized  number  and  loss 
r  ues  !  or  the  second  four  models 

SF  1 0.4 

-SO 

1 11"!. ICOPTF.R s  _  Authorized  number 

SF  1 0.4 

and  loss  rates  for  the 
final  four  models 

1-80 

ATM  -  Authorized  number  and  loss 
rates  for  the  first  four  models 

8F10.4 

1-80 

ATM  -  Authorized  number  and  loss 
rates  for  the  second  four  models 

8F10.4 

1-80 

ATM  -  Authorized  number  and 
loss  rates  for  the  final  four  models. 

8F10.4 

I “>.6  OUTPUT  -  This  utility  produces  one  output  file,  CEMLOSS1.  This  file 
details  for  each  of  the  equipment  model  types  (a  maximum  of  12)  within 
the  four  major  Combat  equipment  categories,  (i.e.,  tanks,  APC’s  heli¬ 
copters  and  ATM's)  the  average  number  of  items  authorized  for  a  spec¬ 
ific  time  period  and  the  percentage  loss  rate  for  that  period. 

As  can  be  seen,  the  utility  has  taken  the  input  order  of  battle  data  and 
accumulated  into  several  time  periods  of  thr  battle.  These  time  periods 
are  further  classified  into  the  intensive  Per  od  and  Sustaining  Period  of 
the  battle.  The  Intensive  Period  is  the  first  90  days  and  the  sustaining 
Period  is  the  last  90  days. 

The  file,  pictured  in  Figure  111.15.3  is  highly  formatted  in  order  that  it 
can  be  humanly  read  as  a  report  for  data  verification  before  it  is  used 
as  an  input  file  to  the  following  utility  CEM/LOSSES.  As  a  result  the 
file  is  self  explanatory  and  the  record  layout  is  not  necessary. 

The  file  is  unique  in  that  it  is  the  only  file  within  the  system  that  is  not 
permanently  saved;  it  is  read  immediately  by  the  following  utility 
CEM/LOSSES.  Thus  if  processing  is  interrupted  in  either  of  these  two 
utilities,  both  will  have  to  be  rerun. 

13.7  PERFORMANCE  -  The  utility  requires  the  following  system  resources 
to  be  allocate3T” 


CORE: 

CPU  TIME: 
CLOCK  TIME: 
DISK  UNITS: 
COMMENTS: 


10  K  OR  LESS 
5  MIN  OR  LESS 
10  MIN  OR  LESS 
1  -  2 
NONE 
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UN  ri  Ar>  SI  FI  £0  ••  *t  X*  MPLE  or  Cf  ml  OC  SI  OUTPUT  HAT*  rpOM  UTILITY  CTM/rUT* 
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AUG  81  S  CAMfLUN.  K  G  MMOAOES  MOA903-B0-D-0668 
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UNCLASSIFIED 


CAA-D-81-2 


UN  CL  AS  SI  FI  EO  ••  *E  XA  MPLC  OF 

CE  ML  OS  SI 

OUTPUT  OATA  FROH 

UTILITY  CCH/DATA 

us: 

iif: 

117: 

ns: 

ns: 
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•  00 

•  14 
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•  00 

•  00 

•00 

•  00 

•  00 

•  00 

•  00 
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i2n: 
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2058.00 
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40.30 

138:  CT  TANK  LOSS  .60  .13  1.21 

193: 

.15 

.00 

.00 

.00 

•  00 

•  00 

•  00 

•  00 

•on 

£  UW  . 

201  :  AVG 

AFC  tUTH  1392.07  262*. 87  1*36.00 

.00 

•  00 

.00 

.00 

•  no 

•  00 

.00 

•  00 

.oc 

2n?:  tot 

APC  LOSS  *07. *3  587.07  6*».69 

20.70 

3.41 

16.25 

102.34 

185.05 

51.41 

374.96 

32  8.09 

87.26 

203!  PC  T 

20** : 

205: 

2  06  1  AVG 
207:  TOT 
2  08  1  PC  T 
209: 

2in: 

APC  LOSS  .  29  .22  .*5 

HfLO  AUTH  323. *0  .00  .00 

MELO  LOSS  209.77  15.96  6*. 67 

HE  LO  LOSS  .65  .0  0  .00 

•  00 

13.40 

15.40 
1*15 

.00 

192.00 

113.53 

.59 

•  00 

.00 

.00 

•  00 

•  00 

•  DO 

.00 

21i:  AVG 

ATH  AUTH  667.  13  603.80  27*6.33 

64.80 

.00 

•  00 

•  00 

•no 

•  00 

.00 

•  00 

•  OC 

2iz:  TOT 

ATM  LOSS  .UO  .00  AST. 52 

8.21 

131.34 

201.42 

431.6? 

36.96 

•  00 

•no 

•  00 

.oc 

213:  PC  T 
2i4t 

215 : 

216 : 

217: 

?ib: 

ATM  LOSS  .00  .  00  .1* 

30-0AT  LOSS 

•13  .00  .00 

RATE  ••  0-31  TO  0-60” 

•00 

•  00 

•  00 

•  00 

•  00 

•  00 

2191  AVG 

TANK  AUTH  3*  22  .60  2058.00  5*. 00 

324.00 

•  00 

•00 

•  00 

.00 

•00 

•0  0 

•  00 

•  CO 

2  20:  TOT 

TANK  LOSS  1716 .18  185.1  8  39.06 

48.47 

7.00 

77.88 

65.90 

213.71 

58.76 

32.30 

75.05 

24.7  0 

2  21  :  CT 
222  : 

223: 

TANK  LOSS  .  50  .09  .72 

•  15 

.00 

.00 

•  00 

•  00 

•  00 

•  00 

•  00 

•or 

2  24  :  AVG 

AFC  AUTH  1878.00  *39*. 87  2771.97 

.00 

.00 

.00 

•  00 

.00 

•  00 

.00 

•  00 

•oc 

2  25  :  To  T 

APC  LOSS  *A  1»  56  772.03  1036.5* 

22.38 

3.19 

15.72 

161.92 

120.78 

69.87 

178.15 

162.50 

114.50 

2  26:  PC  T 
2  27: 

2  26*. 

APC  LOSS  .2*  .18  .37 

•  00 

•  00 

•00 

•  00 

•  00 

•00 

•  00 

•  00 

•  00 

Figure  III.  15. 3  (cont.) 


unclassified«*«example  or  ccmlossi  output  oat*  from  utility  cem/data 


*» 


229: 

23o: 

2  si: 

2  32! 
2  3i: 
2  34! 
2  3?,: 
2  3CT 
237! 
2  38  : 
2  39: 

2*o: 

24i: 

2  42: 

2*t: 

244: 
2*?: 
2  46 : 

247: 

243 : 

24*» : 

2  so: 

25i: 
2  52: 
2  5.7: 
2  54: 
255: 
2  58  : 
2  57  : 
2B$: 
2  59: 

2to: 

2si: 

262: 

263: 

264: 

2€5: 

256: 

267: 

268: 

269: 

2  to: 

27i: 
272: 
273: 
2  74: 
2  75: 
2  76: 
2  77: 
278: 
279: 
2  9o: 
281 : 
202: 

293: 
284: 
285  : 


AVG 

HC  LO 

ALTH 

6  35.80 

.0  0 

•  LO 

22.67 

240.00 

TOT 

HE  LO 

L  05  5 

180.79 

18.9  2 

15.97 

13.48 

54.72 

PC  T 

HC  LO 

LOSS 

.28 

.00 

.00 

.59 

•  23 

AVG 

ATM 

AUTH 

160  3.00 

969.20  5577.87 

162.00 

•  00 

.00 

•  00 

•no 

•  00 

.cc 

•  CO 

TOT 

ATM 

LOSS 

•  00 

.00  966.29 

14.84 

69.18 

54.91 

412.93 

32.93 

•  00 

.cc 

•  oc 

PC  T 

ATM 

LOSS 

•  00 

.00  .17 

•  09 

•  00 

•  00 

•00 

•  00 

•  00 

•  00 

•  00 

3  0-DAY  LOSS 

RATE  •• 

0-61  TO 

0-904* 

AVG 

TA 

NK 

A 

UTH 

4739.00 

2058.00 

54.00 

324.00 

.00 

.00 

•  00 

•  00 

•00 

.0  0 

•  00 

TOT 

TA 

NK 

L 

OSS 

1294 .76 

111.14 

.00 

20.80 

3.52 

52.05 

40*05 

83.42 

29.18 

24.01 

38.50 

CT 

TAN 

K 

LO 

ss 

.  27 

.05 

.00 

•  06 

.00 

•  00 

•  00 

•  00 

•  00 

•  00 

•  00 

AVG 
TOT 
PC  T 

APC  AUTH 
APC  LOSS 
APC  LOSS 

2182.00  5502.00  3573.13 
389.60  542.12  900.34 

.18  .10  .25 

•  ou 

17.72 

.00 

•  00 
2.97 
•  00 

•  00 
13.24 
.00 

•  00 
120.94 
•  00 

•  no 
67.20 

•  00 

•  DO 
53.43 

•  00 

.cc 

137.58 

.00 

•  CO 
85.84 

•  00 

AVG 
TO  T 
PC  T 

HE  LO  AUTH 
HE  LO  LOSS 
HE  LO  LOSS 

794.0  7  .0  0  .UO 

76.01  7.4  1  7.41 

•  10  .00  .00 

29.37 

6.81 

.23 

240.00 
14.47 
•  06 

AV 

G 

ATM 

AU 

TM 

2164.40 

1199.00 

72  7  4 

.67 

162.00 

.00 

•  00 

.00 

.00 

•  00 

•  CO 

.CO 

TO 

T 

ATM 

LO 

ss 

.00 

.00 

736 

.94 

3.44 

45.70 

20.  s« 

2»1.%S 

21.15 

.00 

•  00 

.00 

PC 

T 

ATM 

LO 

ss 

•  00 

•  00 

•  10 

•  02 

•  00 

.00 

.00 

.00 

•  00 

•  00 

.00 

30 

-OAY 

LOSS 

RATE  •• 

0-91  TO 

0-120** 

AVG  TANK  AUTH  4768.00  2058.00  54.00 
TOT  TANK  LOSS  903.57  91.53  .00 

CT  TANK  LOSS  .19  .04  .00 

324.00 
15.54 
•  05 

.00 
4.38 
•  00 

.00 
39.36 
•  00 

.00 

33.14 

•00 

•  00 
54.83 
•  00 

•  00 
16.46 
•  00 

.0  0 
2C  .71 
•  00 

•00 
37.9? 
•  00 

AVG  APC  AUTH  2190.00  5526.00  3587.00 

TOT  APC  LOSS  275.80  383.49  569.40 

PCT  APC  LOSS  .13  .07  .16 

•  00 
28.89 
•  00 

.00 
8.67 
•  00 

•  00 
21.96 
•  00 

•00 
122.72 
•  00 

•  00 
78.56 
•  00 

•  00 
55.10 
•  00 

•  CO 
140*65 

•  00 

•  00 
65*46 
•  00 

AVG 

HE  LO 

AUTH 

797*00 

•0  0 

•  00 

29.50 

240.00 

TOT 

HE  LO 

LOSS 

33.41 

6.2  8 

4.87 

4.58 

13.18 

PC  T 

HE  LO 

LOSS 

.04 

•0  0 

.00 

.16 

.05 

AVG 

ATM 

AUTH 

2174.C0 

1204.00 

7306.00 

162.00 

.00 

•  00 

•00 

•  00 

•  00 

•  00 

•  00 

TOT 

ATM 

LOSS 

.00 

.00 

460.13 

2.09 

50.70 

57.30 

363.58 

16*46 

•  00 

•  nc 

•  CO 

PC  T 

ATM 

LOSS 

.00 

.00 

•  06 

•  01 

•  00 

.00 

•  00 

•  00 

•  00 

•  00 

•  00 

30-OAY  LOSS  RATE  ••  0-121  TO  0-150*4 
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•cr 

•  cc 

•  00 


•  CO 

14.5  9 

•or 


•  cr 

73.45 

•  or 


•  or 

•  or 

•  or 


•ro 

25.5  3 

•or 


•  cr 
70.99 

•  00 


•oc 
•  or 
•oc 


UNCL  AS  SI  FI  ED  ••  *E  XAMPLf  OF  CC  ML  OS  Si  OUTPUT  DATA  FROM  UT  It  IT  V  CEM/DATA 


:•  ir : 
?  *7 : 


r  3P : 

AVG  TAM(  AUTH 

*768  .00 

20  58 .0  0  5*. 00 

32*. 00 

•  no 

7  5* : 

TOT  TANK  LOSS 

1*0*  .95 

70.7  8  39.36 

1*  .  20 

3.20 

:*n: 
m : 

7 12 : 

CT  TANK  LOSS 

.  30 

.03  .7* 

•  0* 

•  00 

:si : 

AVG  Ape  AUTH  2190. UO  5526.00  3587.00 

.00 

•  00 

?** : 

TOT  APC  LOSS 

31*. 70 

577.90  U85.6* 

17.20 

2.57 

7  ir< : 

PC  T  APC  LOSS 

•  1* 

•  10  .33 

•  00 

.00 

?  it : 

2 17 : 

?  : 

AV  G  HE  10  AUT  M 

797 .00 

.0  0  .00 

29.50 

2*0.00 

2<*: 

TO  T  HE  LO  L  OSS 

23.18 

5.86  *  .  *  6 

3.67 

3.33 

ion : 

PC  T  MELO  LOSS 

.0  3 

•DO  .00 

.12 

•01 

3  u  i  : 

in?: 

’oi : 

AVG  ATM  AUTH 

?17*. 00 

120*. 00  7306.00 

162.00 

•  00 

ic* : 

TOT  ATM  LOSS 

•  00 

.00  316.86 

•  00 

2  3.  *5 

3  or> : 

PC  T  ATM  LOSS 

.00 

.00  .0« 

•  00 

•  00 

inf  : 

307  : 

ic? : 
30*: 

no: 

3  0-OAY  LOSS 

RATE  •• 

D-1S1 

in : 

AVG  TANK  AUTH 

*768  .00 

2058.00  5*. 00 

32*. 00 

.00 

?  l? : 

TOT  TANK  LOSS 

801.2* 

21.05  92.65 

9.18 

3.85 

3ii : 

CT  TANK  LOSS 

.  17 

.01  1.72 

•  03 

.00 

3i* : 
315 : 
316 : 

AVG  APC  AUTH 

7190.00 

5526.00  3587.00 

•  OU 

.00 

i  it: 

TOT  APC  LOSS 

1*  *• 03 

285.13  522.3* 

13.73 

2.13 

3ifi: 

PC  T  APC  LOSS 

.07 

.05  .15 

•  00 

•  00 

3i*: 

3  2n: 

32i : 

AVG  HELO  *UTH 

797  .00 

.0  0  .00 

29.50 

2*0.00 

3?7 : 

TO  T  HE  LO  LOSS 

11.3* 

1.12  3.20 

1.37 

1.95 

373  : 
3?*: 
3  2r-: 

PC  T  *  LO  L  OSS 

•  01 

.0  0  .00 

.05 

•  01 

i?f : 

AVG  ATM  AUTH 

217*. 00 

120*. 00  73U6.0Q 

162.00 

•  00 

3-*?: 

TOT  ATM  LOSS 

.00 

.00  *5.87 

•  1* 

12.28 

3?b: 

PC  T  ATM  LOSS 

.00 

.00  .01 

.00 

•  00 

3?b: 

.00 
27.68 
•  00 

.00 
32.29 
•  00 

•  00 
39.00 
•  00 

•00 
2*  .62 
•  00 

.0  0 
18.12 
•  00 

•00 
32.0  3 
•  00 

.cc 

11  .*3 
.00 

•  00 
10.72 
•  00 

.00 
132.57 
•  00 

•  00 
86.  *5 
•  00 

•  00 
H.U 
•  00 

•  00 
109.1* 

•  00 

•  00 
St*lt 
•  00 

.QC 
74.  *e 
.or 

•  00 
8.3? 

•  00 

.60 

120.77 

.00 

.00 

8.05 

•00 

.00 

.00 

.00 

.00 
•  CO 
.00 

.00 

.00 

.00 

.oc 

.00 

.00 

0-180* 

• 

•  00 
25.02 
•  00 

•00 
6.26 
•  00 

.00 
2*  .0* 

•  00 

.00 
23.  T» 
.00 

.0  0 
19  •*  3 
•  00 

.00 

7.3* 

.00 

.ro 

12.7  5 
.00 

.00 
11.08 
•  00 

•  00 
36.*8 
•00 

•no 

72*68 
•  00 

.00 

25.20 

.00 

•  CO 
127.87 

•  00 

.00 

50.3* 

.00 

.oc 

H.5* 

.00 

•  00 

•  QO 

•  00 

.00 

•  00 

•  00 

.00 

5.55 

63.01 

3.56 

•  00 

•  00 

•  00 

•  or 

•  00 

.00 

•  00 

.00 

•  00 

•  00 

•00 

3  to: 

3  n  :»hsg.n 

3  37  :«HSGt  N 
3  31  :6mt  g*n 
3  i*:«hs  g»n 
335:8W?KPT 


T M€  ABOVE  NUMBER  -AS-  IS  REOUIRFO  IN  COLUMNS  35-*0. 

THIS  NUHBFR  REFLECTS  THE  NUMBER  OF  THEATER  CYCLES  BFINO 
PLAYED  TN  the  CfH.  ONE  CE  N  THEATER  CYCLE  IS  EQUIVALENT  TO 
FOUR  DAYS  1*5  X  *  =  190  OAYSI. 

PRINT* 
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CHAPTER  16 
Utility  -  CEM/LOSSES 

16.1  DESCRIPTION  -  The  purpose  of  this  module  is  to  produce  the 
CEM/LOSSES  file  which  will  be  used  later  as  input  to  the 
CONTROL/COMPILER  utility.  This  utility  will  use  as  its  primary  input 
the  82CEMLOSS1  file  which  was  produced  by  the  preceding  utility, 
CEM/DATA.  Further,  it  also  requires  the  user  to  provide  a  list  of 
specific  CEM  weapon  control  numbers  identifying  equipment  models  for 
which  CEM  loss  rates  are  needed.  Using  this  information  the  utility  will 
read  the  82CEMLOSS1  file  and  screen  out  unneeded  data  such  as  the 
authorization  levels,  and  produce  a  summary  of  the  CEM/LOSS  rates  for 
all  models  of  equipment  in  the  study,  further  it  will  select  the  loss  rates 
for  those  models  identified  by  the  user  in  the  runstream  and  write  a 
summary  line  of  these  loss  rates  and  express  them  as  percentages. 

16.2  STRUCTURE  -  Figure  III.  16.1  presents  the  overall  organization  of  the 
utility. 

16.3  DATA  BASE  -  The  data  base  which  supports  this  utility  is  composed  of 
two  major  files;  one  input  and  one  output.  The  input  file  is  the 
82CEMLOSS1  file  which  was  produced  by  the  CEM/DATA  utility.  This 
file  is  an  interim  file  which  will  not  be  cataloged  under  the  study's 
program  file  and  will  be  lost  after  this  runstream  is  executed. 
Therefore,  if  the  current  utility,  CEM/LOSSES,  fails  to  complete  its 
execution,  the  CEM/DATA  and  the  CEM/LOSSES  utilities  must  be  run 
again.  Since  they  are  both  executed  using  the  same  runstream  this 
should  not  cause  a  serious  problem.  The  only  output  from  this  utility  is 
the  CEM/LOSSES  file.  This  file  will  be  cataloged  under  the  current 
program  file,  in  this  case  SECRET*82W ARF P88  and  be  used  as  input  to 
a  following  utility  CONTROL/COMPILER. 

16.4  RUNSTREAM  -  This  utility  is  executed  in  the  same  runstream  as  the 

previous  utility  CEM/DATA  (Figure  14.2).  After  executing  the 

CEM/DATA  utility  and  producing  the  83CEMLOSS1  interim  file,  the 
runstream  sets  up  for  the  CEM/LOSSES  utility.  In  so  doing,  it: 

o  Allocates  logical  unit  7  and  assigns  the  temporary  file 
82CEMLOSS1  to  the  unit. 

o  Executes  the  CEM/LOSSES  utility. 

o  CEM/LOSSES  requires  the  user  to  identify  for  it  the  combat 
equipment  models  for  which  it  will  prepare  and  produce  special 
output  records  in  the  CEM/LOSSES  file.  The  user  will  be  required 
to  enter  the  2  character  CEM  Weapon  Numbers,  one  code  per  line, 
between  the  utility  execution  statement  and  the  EOF  statement  in 
the  runstream  (Figure  HI.  16.2,  Lines  34  and  44,  respectively). 
Figure  III.  16.3  presents  an  example  list  of  CEM  Weapon  numbers 
and  their  explanations.  The  list  of  CEM  Weapon  numbers  will 
change  from  study  to  study.  These  are  provided  by  the  CEM 
operator/analyst.  A  maximum  of  22  models  can  presently  be 
handled  within  the  utility  without  modification  to  the  utility. 
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<v.\ 


IV?*- 


o  The  output  file  is  copied  from  logical  unit  8  to  the  permanent  file 
file.  The  "XX"  portion  of  the  file  name  must  be  changed  to  reflect 
the  CEM  Control  number  being  used.  This  number  can  be  obtained 
from  the  CEM  Operator/ Analyst. 

o  Allocated  units  are  released. 

INPUT  -  The  major  input  to  this  utility  is  the  82CEMLOSS1  file  which 
was  produced  by  the  previous  utility  CEM/DATA.  This  file  summarizes 
information  received  from  the  CEM  LOG  report  as  to  the  authorized 
number  and  loss  rates  for  up  to  12  individual  models  of  four  major  types 
of  combat  equipment,  i.e.,  tanks,  APC's,  helicopters  and  ATM's.  It 
accumulates  this  information  by  the  various  time  periods  of  the  study. 

Figure  III.  15.4  (previous  chapter)  presents  an  example  of  the  data  found 
in  the  file,  since  the  file  is  produced  in  a  report-like  format  which  is 
rather  self-explanatory. 

Also  used  as  input  to  this  utility  is  a  list  of  two  character  CEM  Weapon 
Numbers  which  controls  the  output  of  loss  rates  which  is  produced.  This 
list  is  entered  into  the  runstream  of  the  utility.  Figure  III.  16.3  lists 
these  numbers  and  provides  an  explanation. 

OUTPUT  -  The  CEM/LOSSES  utility  produces  the  CEM/LOSSES  file  as 
its  single  output.  This  file  will  be  used  as  one  of  the  input  files  to  a 
subsequent  utility,  CONTROL/COMPILER.  The  file  itself  is  quite 
similar  in  appearance  to  the  82CEMLOSSI  file  in  that  it  summarizes 
over  a  number  of  time  periods  information  concerning  loss  rate  to  up  to 
12  models  of  four  major  types  of  combat  equipment,  i.e.,  tanks,  APC's, 
helicopters  and  ATM's.  Further,  it  is  formatted  in  such  a  manner  that  it 
is  quite  readable  by  itself.  But  the  file  is  unique  in  that  it  does  not  con¬ 
tain  any  authorization  levels  for  the  equipment,  only  loss  rates. 
Further,  the  last  line  or  record  of  each  time  period  is  entitled 
"R09CEM"  or  "R10CEM"  denotes  the  loss  rates  for  those  items  expli¬ 
citly  entered  by  the  user  in  the  runstream.  See  Figure  III.  16.4. 

FILE:  CEM/LOSSES 
STORAGE  MEDIUM:  Mass  Storage 
SOURCE:  Utility  -  CEM/LOSSES 


RECORD  FORMAT: 


Position 


Description 


Format 


Record  1: 


Number  of  days  in  the  period 
First  day  in  the  period 
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9-12 


Last  day  in  the  period.  (If 
last  day  =  120,  150  or  180, 
the  zero  is  dropped) 


14 


Record  2; 

1-72 

Record  3: 

1-9 

10-105 

Record  4; 

1-9 

10-105 

Record  5: 

1-9 

10-105 


Period  titling  information 


Blank 


Tanks  -  fraction  lost  within 
time  period  for  each  specific  model 
of  tank(a  max  of  12  models) 


Blank 


APC-fraction  lost  within  time 
period  for  each  specific  model 
of  APC  (a  max  of  1 2  models) 


Blank 


HELlCOPTERS-fraction  lost  within 
time  period  for  each  specific 
model  of  Helicopter.  (Presently 
a  max  of  5  models  allowed) 


12(A6) 

9X 

12(F8.2) 

9X 

12(F8.2) 

9X 

4(F8.2) 
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Record  6: 


10-105 


Record  7: 


14-15 


16-104 


A 


Blanks 


ATM-fraction  lost  within  this 
time  period  for  each  specific 
model  of  ATM  (a  max  of  12  models 
is  allowed) 


12(F8.2) 


13(F7.4) 


"R09CEM  01-" 


The  number  of  individual  CEM 
weapon  control  numbers  as  speci¬ 
fied  in  the  runstream 


The  percentage  loss  rate  for 
the  specific  model  of  equipment 
specified  by  the  user  in  the  CEM/ 
LOSSES  runstream.(A  maximum  of  22 
individual  models  is  presently  provided 
for  in  the  model.  It  should  also  be 
noted  that  for  the  first  two  time  periods 
(i.e.,  days  1-15  and  16-30),  these 
loss  rates  are  doubled. 


PERFORMANCE  -  The  following  system  resources  will  be  required  to 
execute  this  utility: 


CORE: 

CPU  TIME: 
CLOCK  TIME: 
DISK  UNITS: 
COMMENTS: 


10K  OR  LESS 
2  MIN  OR  LESS 
10  MIN  OR  LESS 
1  -  2 
NONE 


r 


un:ia3sif:ec*»»file  nametcstart.b2xot  foment  nametcem/lossesa^unclasstfied 


:auS£  88.«SECRET»62WARFP88. 

ISASG.A  38/  / 

TSASG.T  7. 

TSASG.A  73AMP83-XX. 

TSMSG.N  THE  ABOVE  PATA  FILE  ■73AMP88-XX*  IS  CREATED  IT 
TSMSG.N  CEM  SPECIFICLY  FOR  MARF.  THE  FILE  contains  data 
tsmsc.n  on  losses  of  wapf  hie  played  in  cem.  the  -xx* 

TSMSG.N  HUST  OE  chanced  prior  to  the  execution  of  this 
tsmsg.n  RUN  streah  to  hatch  the  appropriate  CEM  run  control 

TSMSG.N  NUH8ER  OF  INTEREST.  THIS  NUMBER  CAN  BE  OBTAINED  FROM 
T  a  MS  G  .  N  the  cem  g  pe  pa  top/ anal  yst. 

:a£D  73  AMP8  8-XX . . 7. 

tcxit 

T8ASG.UP  82CEML0SS1. 

T3KSG.N  THE  ABOVE  TEMPORARY  data  file  ‘32CEMLOSS1’  VILL 
TSHSG.N  CONTAIN  THE  OUTPUT  OF  THE  UTTLITY  *82  XOT.  CEM/DAT  A*  AND 
T8MSG.N  AND  SERVE  AS  INPUT  TO  THE  UTILITY  *82X0T.  CEM/LOSSES* . 

T  3  BR  KP  T  PR  IN  T*  /82CEML0SS1 
:axOT  32  xa  T.  CE  M/DATA 


TSMSG.N 

:  a  ms  g  •  n 


T  a  MS  G  .  N  THE  A  30  VE  NUMBER  *R5"  IS  RE  CU  IRrD  IN  COLUMNS  79-80. 

TSHSG.N  THIS  NUMBER  REFLECTS  THE  NUMBFR  OF  THEATER  CYCLES  BEING 
T3MSG.N  PLAYED  IN  THE  CEM.  ONE  CEM  THEATER  CYCLE  IS  EQUIVALENT  TO 
TSMSG.N  FOUR  DAYS  l«  X  *  :  180  0*YS». 

Iff  BR  KP  T  PRINT* 

TSFREE  7. 

’  TSUSE  7.  .82CEML0SS1. 
i  T8  AS  G.  T  a. 

!  TaXQ  T  82X0T.  CEM/LOSSES 
I  TO  X 
TO  2 
TO  3 
;  TO  4 
T13 
i  T1S 
T2S 
'T29 
!  132 
IT?  EOF 

1I8MSG.N  THE  ABOVE  LIST  OF  NUMBER  CORRESPOND  TO  THE  CEM  UEOPON 
LI8MSG.N  NUM8ERS  OF  VARF  MIE  U  FON  WHICH  CEM  LOSS  R AT rS  ARE 
’TSMSG.N  OESIRED.  THE  CEM  PLAYS  UP  TO  A9  MAJOR  WEOPON  SYSTEMS. 

!  T8E0  9.  .88.CEM/LCSSES-XX 
i  TP  20 
i  TLAST 

;texit 

'TSMSG.N  THE  A  30  VE  ELEMENT  FILE  *C  EM/LOSSE  S-XX*  CONTAINS  THE  OUTPUT 
!  TSMSG.N  OF  THE  UTILITY.  THE  "XX*  MUST  CORRESPOND  TC  THE  APPROPRIATE 
(TSMSG.N  CEM  RUN  CONTROL  NUMBER. 

ITS  FREE  7. 
i  TSFREE  8. 

IT8FREE  A  A . 


Figure  III.  16.2 


i 


a** 


CEM  WEAPON  NUMBER  LIST  (EXAMPLE) 


NUMBER 

EXPLANATION 

01 

Ml  Tank 

02 

M60A1  Tank 

03 

M551  Assault  Vehicle 

04 

M48A3  Tank 

13 

IFV 

15 

M113A1  APC 

25 

AAH 

29 

AH- IS 

32 

Dragon 

Figure  III. 16.3 


unclassified  •  ••c  xanple  of  the  output  from  utility  crw/LossFs***uNCLAss  into 


1 :  is  i  is 


?:  • 

AVfRAGE  IS 

-  0  A  Y 

LOS**  RATTS  .*d- 

1  TO  0- 

15*  • 

3 : 

.32 

.07  .00 

.05 

12.39 

58.56 

4.65 

348.47 

135.66 

58.95 

7.15 

27. 

08 

4 : 

.12 

.11  .18  13 

.17 

1.35 

7.97 

13.10 

126.64 

36.76 

225.05 

217.27 

9. 

53 

5 : 

.3$ 

3.  32  5  5.97 

.75 

.39 

g  : 

.00 

.00  .03 

.no 

92.62 

147.30 

326.03 

25.58 

•  00 

•  00 

•  00 

# 

00 

7:ro9cch 

01-  9 

£4.0  14.0  .0 

10. 

0  24.0 

36 .0 

72.0 

78  .0 

18.0 

9 : 

9 : 
to : 
u : 

l? : 

13 : 

14!  15  16  30 


is: 

AVERAGE  15-DAY  LOSS  RATFS  **D- 

16  TO  0 

-30*  • 

is : 

.28 

.07  .61  .10  5.42  9.98 

3  4.50 

102.00 

70.93 

26.13 

4  7.82 

13.72 

17 : 

.17 

.12  .26  7. S3  2.06  8.29 

89.24 

58.41 

14.75 

149.31 

110.82 

77.73 

18 : 

.  30 

12.65  8.70  .42  .21 

is : 

.00 

.00  .09  .U6  38.72  54.12 

105.53 

11.38 

.00 

.00 

•  00 

.00 

20!R09  ceh 

01- 

9 

56.0  14.0  122.0  20.0  34.0  52.0 

60. 0 

42  .0 

18.0 

?i  : 

??: 

?  3 : 

?« : 

25 : 

?c : 

27:  30 

i 

30 

?p :  to 

i 

60 

29 :  JO 

l 

90 

30 : 

AVFRAGE  30 - 0 A Y  LOSS  RATES  **D- 

1  TO  0- 

90** 

31 : 

.40 

.09  .50  .12  .00  .00 

.00 

.00 

.00 

.00 

.00 

•  CD 

’  r* : 

.23 

.15  .33  .00  .00  .00 

.00 

.00 

•  00 

.00 

.00 

.00 

3 y : 

.27 

.00  .00  .55  .27 

34 : 

.00 

.00  .14  .07  .00  .00 

.00 

.00 

.00 

.00 

.00 

.00 

35  :RQ3CEM 

01- 

9 

40.0  9.0  50.0  12.0  23.0  33.0 

27.0 

27.0 

14.0 

36  : 

37  : 

39 : 
is : 
so : 
«•! : 


42 : 

30 

91 

12 

4  7 : 

30 

91 

1  S 

44 : 

30 

91 

1  8 

45 : 

AVG  30-0 AY 

LOSS 

RATES 

•♦0-91  TO 

0- 1 90 • • 

46 : 

.’2 

.03  .9  2 

.04 

.00 

.00 

.00 

.00 

.00 

.00 

.00 

.00 

47 : 

.11 

.08  .21 

.00 

.no 

.00 

.00 

.00 

•  QO 

.00 

.00 

.oc 

4  8  : 

.03 

.00  .00 

.11 

.03 

49 : 

•  00 

.00  .04 

•  00 

.00 

.00 

.00 

.00 

•  00 

o 

o 

.00 

.00 

so  :R09  cem 

01-  9 

22.0  3.0  82.0 

4.0 

11.0 

21.0 

3.0 

3.0 

4.0 

si : 


S3 : 

S4  : 

ss : 
sr : 

st:  3 o-o • y  loss  rate  •  •  D-l  TO  D-30* • 


figure  III.  16.4 
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Chapter  17 

Utility  -  COUNT/DIVISIONS 

17.1  DESCRIPTION  -  The  purpose  of  this  utility  is  to  produce  the 
COUNT/DIVISIONS  file.  The  COUNT/DIVISIONS  file  summarizes: 

o  The  number  of  divisions  arriving  in  the  theater  period  by  period  for 
the  seven  time  periods  of  the  analysis. 

o  The  average  number  of  divisions  arriving  period  by  period. 

o  The  total  number  of  U.S.  divisions  in  theater  on  D-Day. 

o  The  average  number  of  divisions  in  theater  period  by  period. 

The  utility  uses  as  its  source  of  information  the  73CEM5.BLUE/P88-XX 
file  which  is  produced  by  CEM.  This  file  provides  information  on  each 
division  participating  in  the  theater  conflict,  such  as  its  status  and 
arrival  date  in  theater. 

In  that  the  force  structures,  status  and  arrivals  of  divisions  in  the 
theater  are  relatively  constant  from  each  run  of  the  CEM.  This  utility 
normally  need  only  be  run  once  during  a  study.  The  COUNT/DIVISIONS 
file  will  be  used  as  one  of  the  four  input  files  into  the  following  utility, 
CONTROL/COMPILER. 

17.2  STRUCTURE  -The  overall  structure  of  the  utility  is  pictured  in  Figure 
III.  17.1. 

17.3  DATA  BASE  -  The  COUNT/DIVISIONS  utility  uses  two  files  as  its  data 
base;  one  for  input  and  one  for  output.  The  input  file  is  the 
73CEM5.BLUE/P88-XX  file  which  is  an  input  file  to  the  CEM.  This  file 
describes  divisions  in  theater  and  arriving  in  theater  during  the  period 
of  the  study.  Using  this  data  the  utility  produces  a  short  summary  of 
divisional  strengths  and  arrivals  in  the  theater  for  the  seven  time 
periods  of  the  study.  This  summary  is  written  to  the  output  file 
COUNT/DIVISIONS.  This  file  is  used  as  one  of  the  four  input  files  to 
the  CONTROL/COMPILER  utility  which  follows. 

17.4  RUNSTREAM  -  The  runstream  which  controls  the  execution  is 
cataloged  as  an  element  under  the  program  file  C5TART*82XQT  using 
the  element  name  COUNT/DIVISIONS.  The  runstream  is  depicted  in 
Figure  III.  17.2.  As  the  runstream  executes,  it  accomplishes  the 
following  functions: 

o  Assigns  to  logical  unit  88  the  current  study's  program  file;  in  this 
instance  the  program  file  is  SECRET*82WARFP88. 

o  Requires  the  user  to  provide  the  proper  password  to  gain  access  to 
the  file. 
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o  Assigns  to  logical  unit  8  the  CEM  file  which  details  the  strengths 
and  arrival  rates  of  divisions  into  the  theater.  This  file  will  be  used 
as  the  input  file  to  the  utility.  In  the  current  example  this  file  is 
cataloged  as  an  element  under  the  CEM  program  file  called 
73CEM5;  and  the  file  itself  is  called  BLUE/P88-XX.  In  order  to 
ensure  the  program  file  and  element  names  are  correct  the  user 
should  check  with  the  CEM  Operator/Analyst. 

o  Logical  unit  7  is  allocated  to  accumulate  the  output  from  the 
utility. 

o  The  utility  is  executed. 

o  The  contents  of  unit  7  are  copied  to  the  permanent  file 
COUNT /DIVISIONS-XX  and  cataloged  as  an  element  under  the 
current  study's  program  file.  The  "XX"  portion  of  the  element 
name  must  be  changed  to  correspond  to  the  CEM  input  file  control 
number,  for  example  73CEM5.BLUE/P88-XX. 

o  Allocated  resrurces  are  released. 

17.5  INPUT  -  There  is  one  input  file  to  this  utility.  The  file  is  an  input  to 
the  CEM  model  and  describes  the  relative  sizes  and  arrivals  of  specific 
divisions  in  the  theater.  In  the  current  example  the  file  is  cataloged  as 
an  element  under  the  CEM  program  file  7)C EM5  using  the  element 
name  BLUE/P88-XX.  The  proper  program  file  and  element  names  can 
be  obtained  from  the  CEM  Operator/ Analyst.  Record  layout  for  the  file 
is  as  follows: 


FILE:  73CEM5.BLUE/P88-XX 
STORAGE:  Mass  Storage 
SOURCE:  CEM 

RECORD  FORMAT: 


Column 

Description 

Format 

1  -  10 

TITLE 

A10 

11  -  19 

Division  Name 

A9 

20  -  22 

BLANK 

3X 

23  -  25 

First  Coordinates  of  FEBA 

Sector 

13 

26  -  27 

BLANK 

2X 

28  -  30 

Second  set  of  Coordinates 

FEBA  Sector 

13 

31  -  44 

BLANK 

19X 

50 

_ 

Ai 
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51  -  71 

BLANK 

21X 

72 

Type  of  CEM  partition 

11 

1 

BLANK 

IX 

2  -  6 

TITLE 

A5 

7  -  10 

BLANK 

4X 

11  -  12 

Cycle=Number  of  4-day 
periods  in  the  CEM 

12 

13  -  15 

NUM 

A3 

16 

BLANK 

IX 

17  -  18 

First  day  of  cycle  of 
arriving  units 

12 

19 

BLANK 

IX 

20 

Code  1-used  to  check  if  a 
ghost 

A  =  ACTIVE 

5A  =  GHOST 

A1 

21  -  22 

Second  day  of  the  cycle 
of  arriving  units 

12 

17.6 


17.7 


OUTPUT  -  This  utility  produces  one  output  file  referred  to  as 
COUNT/DIV1SIONS-XX.  The  file  will  be  cataloged  as  an  element  under 
the  current  study's  program  file  (e.g.,  SECRET*82WARFP88).  The  file 
will  contain  a  summary  of: 

o  The  total  number  of  divisions  arriving  in  the  theater  time  period  by 
time  period. 

o  The  average  number  of  divisions  arriving  in  the  theater  by  period. 

o  The  total  number  of  divisions  in  the  theater  on  D-Day. 

o  The  average  number  of  divisions  in  the  theater  by  period.  Figure 
111.17.3  presents  an  example  of  the  data  contained  in  the  output 
file. 


PERFORMANCE  -  This  utility  will  require  the  following  resouces  to 
execute  properly. 


CORE: 

CPU  TIME: 
CLOCK  TIME: 
DISK  UNITS: 
COMMENTS: 


5K  OR  LESS 
3  MIN  OR  LESS 
5  MIN  OR  LESS 
1  -  2 
NONE 
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:i scst ri it  •••*■  u <  name  :cst  art.s?  xqt  element  namc:scunvrivistons«**unclass:fi 


1  :sus 
7  (3  AS 
» -a  as 
i  :sas 
5  :seo 
c  :exi 

7  J3MS 

8  :shs 

9  :sm$ 

ic  :sas 
u  :sas 
it  :sx3 
l.i  :sco 
in  :lnp 

IttCXI 

16  ISMS 

17  ISMS 

is :sms 
ib:sms 
2P  :sms 
?i  :sms 
22  :sms 

2'  tSFR 

?i  :a  fr 

25  CSFR 
21  1SFR 


3  .  .  SF  CRET.82WAREP88. 

38/  / 

8  » 

7  3CE  MS. 

5Cf  MS  .8LUF/P83-XX,8. 

THE  ABOVE  FROCRAM  FILE  *73CFM5*  AND  CLCMENT  "BL0E/P88-XX* 
MAY  CHANCE  FROM  STUDY  TO  STUDY.  TO  INSURE  THEY  ARE  correct 
CHECK  WTTH  THE  CE  M  CP  FRAT  CR /AN  AL  Y  ST. 

7. 

82XQT. 

ZXfiT.  COUNT/DIVISIONS 
.  .38.  COUNT/ DIVISIONS- XX 


C.N  THE 
C.N  OUT 
C.N  T  HE 
C.N  THI 
C.N  EVE 
C.N  THI 
C.N  STA 
CE  7  3CEM 
CE  7. 

EE  8. 

EE  88. 


ABOVE  ELEMENT  FILE  *  COUNT/DIV  IS  IONS-XX*  CONTAINS  THE 
PUT  OF  THIS  UTILITY.  THE  "XX*  SHOULD  CORRESPOND  TO 
CEM  INPUT  FILE  CONTROL  NUNPFR  (IE.  7  3  OEMS  .BLUE  /°8  8- XX  >  < 
S  rILE  IS  RARELY  RUN  MORE  THAN  ONCE  "URING  A  STUDY 
N  THOUGH  THE  CEM  WILL  BE  EXECUTED  COUNTLESS  TIMES. 

S  IS  D Ur  TO  THE  FACT  THF  FORCE’S  STRUCTURE  AND  ARRIVALS 
Y  RELATIVELY  CONSTANT. 

5. 


Figure  III.  17.2 
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UNCLASSIFIEO*»«E  XAMPLE  OF  THE  output  from  utility  C0UNT/DIVISI0NS»»»UNCLASSIFIED 

i:  total  number  of  arriving  divisions  by  period. 

2 :  a  2  0  0  0  0  0 

3:  AVERAGE  NUMBER  OF  ARRIVING  DIVISIONS  BY  PERIOD. 

4t  fi  .062  1.5U0  0.000  0.000  0.000  O.OQU  0.000 

s:  NUMBER  OF  US  DIVISIONS  IN  THEATER  ON  D-DAY. 

e  :  4  2 

7:  THE  AVERAGE  DIVISIONAL  COUNT  BY  PERIOD. 

SI  48.X  Sl.S  52.0  52.0  52.0  52.0  52.0 


Figure  III.  17.3 


204 


Chapter  IS 

Utility  -  CONTROL/COMPILER 


■V.V* 


I 

it 

i 

5 

* 


18.1 


18.2 

18.3 


18.4 


DESCRIPTION  -  The  purpose  of  this  utility  is  to  gather  and  organize 
data  from  five  input  files  and  produce  the  CONTROL/XX  file.  This  file 
will  be  used  in  conjunction  with  the  current  ITMID/F1NAL  file,  which 
was  produced  by  the  earlier  ITM1D/REC-A  utility,  as  the  two  input  files 
to  the  Equipment  Loss  Consolidator  (ELCON)  program  which  follows. 

The  five  files  used  as  input  to  the  CONTROL/COMPILER  utility  are: 

o  CONTROL/TEMP 
o  COUNT/DIVISIONS, 
o  SCENARIO/XX, 
o  REDARTY/DEGR-XX,  and 
o  CEM/LOSSES. 


STRUCTURE  -  Figure  III.  18.1  displays  the  overall  structure  of  the 
utility. 


DATA  BASE  -  The  data  base  which  supports  this  utility  is  the  most 
complex  of  the  Materiel  Postprocessor  system.  The  data  base  consists 
of  data  files;  five  input  and  one  output  files.  The  files  will  be  discussed 
in  more  detail  in  the  following  input  and  output  sections. 

RUNSTREAM  -  The  runstream  which  controls  the  execution  of  this 
utility  is  pictured  in  Figure  III.  18.2.  This  runstream  is  cataloged  as  an 
element  under  the  program  file  CSTART*82XQT  using  the  element 
name  CONTROL /COMPILER.  As  the  runstream  executes,  it  accom¬ 
plishes  the  following  functions: 


o  Assigns  to  the  logical  unit  88  the  current  study's  program  file;  in 
this  current  case  SECRET*82WARFP88.  It  further  requires  the 
user  to  supply  the  proper  password  to  obtain  access  to  the  file. 

o  Assigns  the  following  logical  units  the  designated  files  for  pro¬ 
cessing: 


Logical  Unit 


File 


7 

8 

9 

10 
11 
7 


CONTROL/TEMP 

COUNT/DI  VISIONS-XX 

SCENARIO/XX 

REDARTY/DEGR-XX 

CEM/LOSSES-XX 

OUTPUT 


As  is  the  case  with  other  MPP  utilities,  the  XX  portions  of  the  file 
names  must  be  replaced  with  the  CEM  control  numbers  or  input  data 
files  prior  to  the  execution  of  the  utility.  This  information  can  be 


> 


t 

i 

i 


i 

i 

i 

i 
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obtained  from  either  the  CEM  Operator/ Analyst,  in  the  case  of 
REDARTY/DEGR-XX,  or  from  the  previous  MPP  utilities  which 
produced  the  COIJNT/D1V1SIONS-XX,  SCENARIO/XX,  and 
CEM/LOSSES-XX  files. 

o  The  utility  is  executed. 

o  The  contents  of  the  output  file  in  logical  unit  2  are  copied  to  the 
permanent  file  CONTROL/XX  which  is  cataloged  under  the  current 
study's  program  file,  in  this  case  SECRET*82WARFP88.  The  "XX" 
portion  of  the  file  name  must  be  modified  prior  to  execution  of  the 
program  to  reflect  the  proper  CEM  control  number.  This  number 
can  be  obtained  from  the  CEM  Operator/ Analyst. 

o  The  allocated  resources  are  released. 

18.5  INPUT  -  The  source  of  data  for  this  utility  will  be  provided  by  a  col¬ 
lection  of  five  existing  files.  Three  of  the  files  will  have  been  automa¬ 
tically  produced  by  other  MPP  utilities,  which  must  have  been  success¬ 
fully  completed  prior  to  the  execution  of  this  utility.  These  three  files 
are  COUNT/DIVISIONS-XX,  SCENARIO/XX,  and  CEM/LOSSES.  The 
remaining  two  files,  CONTROL/TEMP,  and  REDARTY/DEGR-XX  are 
manually  created  by  the  user  via  the  system  editor.  Source  document 
for  the  CONTROL/TEMP  file  will  be  the  previous  study's  control  file; 
the  source  document  for  the  REDARTY/DEGR-XX  file  will  be  the  LOG 
REPORT  produced  by  the  CEM.  Each  input  file  will  be  discussed  below. 

o  CONTROL/TEMP  -  As  noted  above  this  file  is  created  manually  by 
the  user,  using  the  previous  study's  CONTROL  file  as  its  source. 
This  file  will  provide  to  the  output  file  both  its  form  and  selected 
elements  of  information  such  as: 

oo  Run  parameters  or  control  data, 

oo  Number  of  days  in  each  period, 

oo  For  each  of  the  loss  rates  specified,  the  first  and  the  last  time 
period  considered. 

oo  Intertheater  transportation  loss  fraction  by  air,  sea  and  LOC. 

oo  For  each  of  the  k  combat  postures,  the  fractional  daily  loss  for 
each  of  the  22  vulnerability  categories. 

The  remaining  records  inserted  into  this  file  will  be  zeroed  out.  These 
records  wil  be  completed  by  the  utility  using  data  extracted  from  the 
remaining  four  input  files. 

o  COUNT/DIVISIONS  -  This  is  the  second  of  the  five  input  files  to 
this  utility.  It  will  supply  to  the  utility  the  number  of  Blue  divi¬ 
sions  in  theater  on  a  period  by  period  basis. 
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o  SCENARIO/XX  -  This  is  the  third  file  to  be  used  by  the  utility. 
This  file  was  produced  by  the  SEARCH/ENGAGEREP  utility  and 
denotes  for  each  of  the  four  postures,  the  daily,  fractional  loss 
suffered  in  each  of  the  22  vulnerability  categories. 

o  REDARTY/DEGR-XX  -  This  is  the  fourth  file  to  be  used  by  this 
utility.  This  file  was  created  manually  by  the  via  computer  term¬ 
inal  edit  WARF  analyst  sponsor  using  data  supplied  by  the  CEM 
LOG  REPORT  on  RED  LOGISTICS  EFFECTIVENESS.  From  this 
data  the  utility  will  record  the  fraction  of  full  strength  Red 
artilery  effectiveness  to  be  applied  by  time  period.  The  example  at 
Figure  IS. 6  must  be  strictly  followed. 

o  CEM/LOSS  -  This  is  the  fifth  and  final  file  to  be  used  as  input  by 
this  utility.  Using  this  data  the  utility  will  record  in  the  output 
file,  one  record  for  each  of  the  seven  time  periods  in  the  study 
detailing  within  each  record  percentage  losses  per  30  days  of  the  12 
types  of  equipment  considered  in  the  theater  model. 


Using  these  five  input  files  the  utility  simply  formats  and  writes  the 
CONTROL/XX  file  as  its  output.  Examples  of  these  files  and  their  data  can  be 
found  in  Figure  III.  18.3  through  18.7  which  follow  this  section. 


18.6  OUTPUT  -  There  is  only  one  output  file  produced  by  this  utility.  It  is 
called  the  CONTROL/XX  file.  The  file  is  cataloged  as  an  element 
under  the  current  study's  program  file  and  will  be  used  as  one  of  the 
three  input  to  the  ELCON  utility.  The  file  uses  the  exact  same  format 
as  the  CONTROL/TEMP  file  that  was  used  as  one  of  the  utility's  input 
files.  Further  much  of  the  data  that  was  present  in  that  file  was  simply 
copied  to  this  output  file  as  was  discussed  earlier.  The  remaining  in¬ 
formation  contained  in  this  file  was  supplied  by  the  other  four  input 
files.  It  should  be  emphasized  that  no  data  in  this  file  is  derived;  the 
data  is  simply  read  from  the  input  files,  organized  and  written  to  this 
output  file  by  the  utility. 


The  output  from  this  utility  will  consist  of  eleven  record  types.  The 
first  format  of  the  first  record  type  is  presented  in  Figure  18.8.  As  can 
be  seen  this  record  will  allow  the  user  to  control  how  the  ELCON 
program  will  execute  and  how  its  output  will  be  formatted  and  stored. 
The  subsequent  ten  records  will  provide  essential  elements  of  informa¬ 
tion  to  the  utility.  A  short  description  of  these  records  and  their 
contents  follows.  Figure  III.  18.8  presents  an  example  of  the  data  found 
in  the  file. 
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FILE;  CONTROL /XX 

STORAGE;  Mass  Storage 

SOURCE;  Utility  -  CONTROL/COMPILER 

RECORD  FORMAT 


Column 

Description 

Format 

1-5 

Number  of  time  period  on 
which  data  is  being  input. 

15 

6-10 

Maximum  sequence  number  of  list 
of  materiel  items. 

15 

11-15 

Number  of  types  of  items  on  which 
combat  loss  data  is  derived  from 
theater  simulation  (currently  CEM). 

15 

16-20 

Number  of  sets  of  loss  rates 
to  be  computed  for  each  item. 

15 

21-25 

=  0  if  historic  loss  matrix  has  not 
been  computed  for  each  item  and 

15 

period  and  stored  in  a  previous  run; 

=  1  if  previously  computed  matrices 
are  read  on  Logical  Unit  2. 

15 

26-30 

Number  of  periods  for  which 
replacement  equipment  is  prestocked. 

15 

31-35 

=  0  for  short  printout; 

15 

=  1  for  long  printout. 

-  -1  for  no  printout  (File  7  and 

File  S  output  only). 

Number  of  records 

Description 

Format 

1  or  2  (as  needed) 

No.  of  days  in  each  time  period 

1615 

1  per  set  of  rates 

First  and  last  period 
considered  in  ith  set  of  rates 

215 

1  or  2  (as  needed) 

Intertheater  loss  fraction 
by  time  period  for  air  shipment 

16F5.4 

1  or  2  (as  needed) 

Intertheater  loss  fraction 
by  time  period  for  sea  shipment 

16F5.4 

ii 


V 

I 

1 

S 
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1  or  2  (as  needed) 


In-theater  LOC  loss  fraction 
by  time  period 


16F5.4 


CONTROL/COMPILER  STRUCTURE 


CEM 


CEM 
LOO  REP 


ENTRY  OF 
REOARTY/OEGR  XX 


SENARIOXX 


REDARTY/DEGR-XX 


CONTROL/ 

TEMP 


COUNT 
DIVISIONS- XX 


CEMILOSSES-XX 


CONTROL/ 

COMPILER 


CONTROL-XX 


Figure  HI.  18.1 


210 


nglasstfied».»f  he  name:cgtadt*S2xqt  element  name : rcNTPOL/ccMrTLfR*"*uNCL ass  i  f 
i:su'r  38..st  CRrT«s2wtRtrae. 

2  I  a  AS  G  •  A  88/  / 

X  :s  At  G.  T  7. 

a:ato  as  .control/temp.7. 
f  :exit 

ElaMSG.N  THE  ABOVE  rLEMFNT  FILE  * C CNTROL/T EMP •  CONTAINS  DATA 
7  : 3  MG  G  *  N  ON  TWO  tECTIONS  OF  THE  CONTROL  FILE  THAT  MUST  BE  MANUALLY 
9  1 3  MG  G  •  N  ECITTCO.  THIS  UTILITY  USES  THIS  DATA  IN  CREATING  THE 
B  1  3  MS  G  •  N  COMPLETEC  CONTROL  F  IL  E  . 

’OtaASG.T  8. 

n:afo  as  .couNT/civisiONS-xx.a. 
i? :e  xi t 

1 3  1  a  MG  G  •  N  THE  ABOVE  ELEMENT  file  "COUNT/DIVISIONS-XX*  contains 
lATaMSG.N  THE  OUTPUT  DATA  OF  UTILTITY  "3  2XG  T  .  CC  UN  T/C I  VI  SI  ONS  *  .  THE 
15:aMS3tN  "XX*  IN  THE  ELEMENT  N  «ME  SHOULD  MATCH  THE  APPROPRIATE  CEM 
IE  laMGG.N  BLUE  cORCE  INPUT  DATA  FILE. 

17:aAGG.T  9. 

l«:aE3  38  .SCE  NARI  O/XX  .9. 

ib:exit 

?r.:aMsG.N  the  above  element  file  "Scfnario/xx*  contains  the  output 

21  !  S  MG  G  *  N  DATA  FROM  UTILITY  "22  X  0T  .  GF  ARCH/ENGAGEREP"  ON  THE  PERCENT 

22:sm<-g,n  of  time  us  forces  spent  in  the  pour  com°at  postures 

2i:aMSC.N  EOR  EACH  TIME  EERICO.  THE  "XX*  IN  THE  ELEMENT  NAME  MUST 

2R:aMSC-.N  MATCH  THE  APPROPRIATE  CEM  RUN  CONTROL  NUMBER. 

?5:aASG.T  io. 

2€ 13  ED  38 .RED  AR  TY/DEGR-XX • 10. 

27  :exi  t 

26  : 3  MG  G  .  N  THE  ABOVE  ELEMENT  FILE  *  RED  ART  Y/DEGR- XX"  CONTAINS 
28 :  a  MG  G»  N  DATA  CN  RED  ARTILLERY  CAPABILITY  FOR  EACH  TIME  PERIOD  1EX- 
TOiaMSG.N  P  RE  SG  SC  IN  ROWS  EXPENDED!.  THIS  DATA  WAS  MANUALLY  GDITTCD 
3I1BMSG.N  FROM  THE  CEM  LOG  REPORT  (73L00RrP).  THE  "XX"  IN  THE 
32 1  a  MG  G»  N  ELEMENT  NAME  MUST  MATCH  THE  APPROPRIATE  CEM  RUN 
3i:aMGG.N  CONTROL  NUMBER. 

3u  :3as  g.  t  ii. 

3E:aE0  83  .CEM/LCGSES-XX.11. 

3S  .-EXIT 

'7:SMrG.N  THE  ABOVE  ELEMENT  E  II  E  ’  C  EM /L  CSGE  G-XX"  CONTAINS  OUTPUT 
3313MGG.N  OATA  FROM  THE  UTILITY  "9  2  XG  T  .  CF  M /LC  GSE  S"  ON  THE  LOGS  RATES 

3e:aMSG.N  for  warp  mif  played  tn  oem.  thf  "xx’in  THr  element  name 

80 1  a  MS  G»  N  MUST  CORRESPOND  TO  THE  APPPCPPIATE  CEM  PUN  CONTROL  NUMBER. 

8i:aAtc.T  2. 

8?:3A5G.A  82  XG  T. 

■»3:aXGT  32XGT.  contrcl/compiler 
88:seo  2. .aa. cc ntrcl/ xx 
as  :lnp  < 
me  :f xi t 

87:SMSG.N  THE  ABOVE  ELEMENT  F  II  r  "  C  ONTRCL  /X  X"  CONTAINS  THE  OUTPUT 

«s:aMGG.N  of  this  utility  which  will  servf  as  input  to  the  el^cn. 

48:3MSG.N  THl  "X"  IN  THE  rL  EM  EN  T  NAME  MUST  MATCH  THE  APPPCPPIATE  OEM 
50iaMSG.N  RUN  CONTROL  NUMBER. 

F>1  :  3f  R  EE  7. 

S2:aPREE  8. 

S3 :a fr ee  9. 

S8  : a er  ee  io. 

5F, :  a  free  ii. 

GETS  FREE  2. 

57:afPEE  88. 

Figure  III. 18.2 
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UNCLASSIFIED«»»EXAMPLE  OF  A  CONTROL/TEMP  DATA  FILE  •  •  «UNCL  A  SS IFIFD 
i:aod  83. CONTROL/TEMP 

?:TEMPORARY  CONTROL  DATA  file  WARF  P83(I20EC80I 


3 : 

7 

1200 

13 

10 

0 

2 

-1 

4 : 

j.5 

15 

30 

30 

30 

3  0 

30 

r,  • 

1 

1 

6  : 

2 

2 

7 : 

1 

2 

a  : 

3 

3 

9 : 

4 

4 

in: 

5 

5 

n : 

6 

6 

12: 

7 

7 

13: 

1 

4 

14 : 

5 

7 

is : 

.05 

•  U  5 

.05 

.01 

.01 

.00 

.00 

16 : 

.15 

.15 

.  23 

.10 

.05 

.0  2 

.00 

17: 

.  15 

.15 

.  10 

.10 

.05 

.0  5 

.05 

is : 

0  .0 

0.0 

0.0 

0.0 

0.0 

0.  0 

0.0 

n: 

•noo 

.non 

.000 

.000 

20 : 

.0  00 

.QUO 

.000 

.000 

21 : 

.000 

.000 

.000 

.000 

22 : 

.0  00 

.000 

.000 

.000 

23 : 

.000 

.000 

.000 

.000 

24 : 

.0  00 

.000 

.000 

.00  0 

2r> : 

.0  00 

•  000 

.000 

.000 

26 : 

.000 

.99  4 

.211  1. 686 

.22  2 

.111 

•  666 

.090  .138 

.899 

.574 

?7 : 

.  22  R 

.691 

.264 

.  71  R 

.  99  9 

•  744 

.359 

.807  .644 

.921 

.100 

29 : 

.  100 

.99  2 

.GOO  2.7RR 

.57  8 

.000 

.299 

.000  .704 

.□no  2 

.192 

29 : 

7.637  3 

.339 

.668  1.750  1 

.19  9 

.50? 

.078 

.515  .597 

.000 

.080 

30 : 

.  700  2 

.507 

1.254 

.92  7 

.49  4 

.000 

.633 

.000  .283 

.284  1 

.609 

3i : 

6 . 75  3  3 

.  355 

.895  3.001  1 

.67  8  1 

.789 

.465 

.898  .566 

.000 

.090 

3? : 

.050 

.25  5 

.OCR 

.  555 

•  68  8 

.010 

•  088 

.550  .823 

.760 

.064 

33: 
3r  : 

3.1R2  7 
.000  . 

.  RG  0 
000  . 

.533  .850 

□00  .000  .000 

.97  3 
.0  00 

•  3R  9 
.000 

.077 

.050  .778 

.000 

.080 

35 : 

.00 

.00 

.00 

.00 

.00 

.00 

.00 

.00  .00 

.00 

.00 

.00 

36 : 

.00 

.00 

.00 

.00 

.  00 

.00 

.00 

.00  .00 

.00 

.00 

.00 

37 : 

.00 

.00 

.00 

.00 

.  00 

.00 

.00 

.no  .oo 

.00 

.00 

.00 

38 : 

.00 

.00 

.00 

.00 

.  00 

.00 

.00 

.00  .00 

.00 

.00 

.00 

39 : 

.00 

.  00 

.00 

.00 

.  DO 

.00 

.00 

.00  .00 

.00 

.00 

.00 

4n : 

.00 

.  00 

.00 

.00 

.  00 

.00 

.00 

.00  .00 

.00 

.00 

.00 

41 : 
42 : 
43  :i 

•  GO 

COMMENTS 

.00 

.00 

.00 

.  00 

.00 

.00 

.□0  .00 

.00 

.UO 

.00 
►  • 

44 : 

THE 

An  OV  E  elemfnt 

ftle 

•CONTROL/TEMP"  TS  CPEATED  By  MANUALLY 

rs:  eoittinc  a  previous  studies  control  ftlf  into  the  current 

<<6  :  WARE  STUDY’S  PPOGRAM  FILE  (IN  THIS  EXAMPLE  "  SE  CRET  •  8  2W  AP  FP88*  1 . 

47:  LINTS  1-lf.  MUST  BE  EDITTED  WITH  THE  CURRENT  STUDY  DATA  ON 

<*8  :  RTORTTNC  AS  DIRECTED  BY  THE  STUDY  OIRFCTOR  AND  IAW  TA9LES 

49.’  4-4  AND  4-5  Or  THE  EICON  MANUAL  CAA-D-T9-3.  DATFD  AUGUST  1979. 

so:  these  lines  contain  data  on  the  »time  periods.  *lin  CODES, 

si:  AC  FM  ITEMS.  XRATES  TC  BE  COMPUTED.  AOAYS  OF  PR  EDOE  IT  TONE  D 

52:  STOCK.  TYPE  OF  RETORT,  LENGTH  OF  TIME  PERIODS.  INT<-IUHEATER 

S3:  LOGISTIC  (SEA  AND  AIFI  LOSSES.  AND  INTRATHEATER  LOGISTIC 

SR  :  LOSSES.  FOLLOWING  THE  COMPLETION  OF  w  AP  FR  AM  AND  THE  CALCUL- 

5S:  ATTON  OF  LOSS  RATES  FOR  THE  22  ARTILLERY  VULNERABILITY 

56:  CATEGORIES  FOR  EACH  COMBAT  POSTURE  LINES  25-32  MUST  BE  FILLED 

57:  IN  WITH  THIS  DATA  IAW  TABLE  A  -5  OF  THF  ELCON  MANUAL  MENTIONED 

581  ABOVE.  THESE  LINE  NUMBERS  MAY  CHANGE  DUE  TO  THE  ADOITION  OR 

59:  OELETION  OF  DATA.  THE  REMAINDER  OF  TH«-  FILE  CURRrNTLY  SHOWN 

FO:  WITH  ZEROS  WILL  BC  FILLED  OUT  BY  THE  EXECUTION  OF  UTILITY 

6i:  -82XDT.C0NTR0L/C0MPI  LER’.  THIS  UTILITY  WILL  CPEAT  A  NEW 

67:  CONTROL  FILE  ELEMENT.  WHICH  WILL  BE  USED  IN  THE  EXECUTION 

83:  OF  ELCON. 


Figure  III. 18.3 
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UNCLASSIFIED.  .  «E  XAMPLE  OF  THE  OUTPUT  FROM  UTILITY  COUN T/ 01 VI SIONS • » *UN CL AS SIFIEO 


1:  total  number  of  arriving  divisions  by  period. 

2".  8200000 

T.‘  average  NUMBER  of  arriving  divisions  by  period. 

«:  E..0b2  1.500  C  .000  0.000  0.000  0.000  0.000 

5:  NUMBER  OF  US  DIVISIONS  IN  THEATER  ON  D-DAY. 
g  :  4  2 

t:  the  average  divisional  count  by  period. 
a:  48,1  51.5  52.0  52.0  52.0  52.  0  52.0 


Figure  III.  IS. 4 


UNCL  AS  ST  FI  CD  ••  *C  XA  HPLC  OF  THE  OUTPUT  FROM  UTILITY  SC  ARCH/ENGAGEREP* ‘‘UNCL ASSIF IC 


i : 

IC  YCLC  = 

1 

BLUE  PARTITION 

i 

2 : 

IC  YCLE  : 

2 

BLUE  FAPTITTDN 

i 

3 : 

IC  YC  LE  = 

3 

BLUE  PARTITION 

i 

*» : 

IC  YC  LE  = 

* 

BLUE  MRTITTON 

i 

5 : 

IC  YC  LE  : 

5 

BLUE  P*PT IT  TON 

i 

6 : 

IC  YC  LE  : 

S 

BLUE  PARTITION 

i 

7 : 

IC  YC  LC  = 

7 

BLUE  PART ITTON 

i 

a : 

IC  YC  LE  = 

8 

BLUE  MRTITTON 

i 

q  : 

IC  YCLE  - 

9 

BLUE  MR7  IT  TON 

i 

in: 

IC  YCLE  r 

10 

BLUE  MRTITTON 

i 

n : 

IC  YC  LE  = 

11 

BLUF  MPT  ITTON 

i 

12! 

IC  YC  LE  = 

12 

BLUE  F ART  ITTON 

i 

13: 

IC  YC  LE  : 

13 

8LUE  MPTITTON 

i 

i«* : 

IC  YC  LE  = 

1* 

BLUE  PARTITION 

i 

15 : 

IC  YC  LE  = 

15 

BLUE  MRTITION 

i 

16  : 

.0 

17 : 

.0 

is : 

.0 

ia: 

.0 

20 : 

2*  3.7 

?i : 

33  3.2 

22: 

39.6 

23  : 

2S70.6 

24 : 

20  2.0 

2*;: 

26 : 

27 : 

28 : 

: 

IC  YC  LE  ; 

16 

8 LUC  PARTITION 

i 

30 : 

IC  YC  LE  r 

17 

blue  partition 

i 

3i : 

IC  YC  LE  = 

18 

BLUE  PARTITION 

l 

32: 

IC  YCLE  - 

19 

BLUE  PARTITION 

i 

33 : 

IC  YC  LE  — 

20 

BLUE  PARTITION 

l 

34 : 

IC  YC  LE  : 

21 

BLUE  PARTITION 

l 

35 : 

IC  YC  LE  = 

22 

BLUE  PARTITICN 

i 

36 : 

IC  YC  LE  = 

t  3 

BLUE  PAPTITtON 

i 

37: 

IC  YC  LE  = 

2* 

BLUE  PARTITION 

l 

35 : 

IC  YC  LE  = 

25 

BLUE  PARTITION 

i 

38: 

IC  YC  LE  : 

26 

BLUE  PARTITION 

i 

40 : 

IC  YC  LE  - 

27 

BLUE  PARTITION 

i 

4i : 

IC  YC  LE  r 

28 

BLUE  PARTITION 

i 

42 : 

IC  YC  LE  : 

29 

BLUE  PARTITION 

i 

43 : 

IC  YC  LE  - 

30 

BLUE  PARTITION 

i 

44 : 

21  3.9 

45 : 

33  9.5 

4E : 

28  6.3 

47 : 

30.3 

48 : 

*7  5.9 

48 : 

6*  *.D 

50 : 

7  0.7 

5i : 

531  *.» 

52: 

*5  7.0 

53 ; 

54 : 

55 : 

5&: 

57 : 

IC  YC  LE  = 

31 

BLUE  PARTITION 

l 

Figure  III. IS. 5 

.ODD 
.171 
•  U12 
.817 


.109 

.1*5 

.009 

.737 
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«jk:l  *<sss  v IC0**«C  XANPLt  of  Input  DATA  RfnARTT/OCCR  TO  UTILITY  CONTROL/CONPXlfR 

i;  cr*  *C  PORT  GFNf  RA  T  OR 

•  T  JCf  N$-RU»N5rC/P8F-®lS  8*C  QTOCTBO  «UNCL  ASSl* ICO* 

Rrn  tOGisTic  r*PfRiCNCf  by  najor  m*  type 


CUANTT  TIES  SMCifN  f  ft®  f«0 
Cr  T Mf  ATrR  CTCLf  UNLESS 


•  ; 

ftATff TRY 

APT  AN  P 

T  T  PF 

WITHIN 

C ATFGOBT 

TOTAL 

OISPLAY 

UNIT5 

TONS 

OrKCftVTSC  LA  4f LCD. 

r : 

T  *TR 

f  3**°  »T 

UNIT 

GAINS  TO  THEATER 

THFATER 

IN  PC 

CCH9AT  LOSS 

NON-CONBAT 

TOTAL 

CL  • 

STOCKS 

ST  OC  K6 

PAIR 

-  — — r*pfPTr  ncf 

—  —  —  - 

LOSSES 

LOSSES 

r  r®  - 

pr  - 

Pf  - 

TOTAL 

A  ’  f  NO- 

AT 

TOT  AL 

nuPTNr 

to: 

c«i  :t  o 

MANC 

r  r*  t 

VjPPL  t 

PAIR 

r  A  TN- 

CYCLE 

FNC 

t  r  np  • 

PF  ®N  . 

CO**«A  T 

TC  NP. 

PFRN. 

’«.  CYC. 

_  __  _ 

_ 

_ _ 

....... 

—  ■ - 

-  — - 

— 

— 

- — — 

— •  —  - 

1C6T76 

100  .0 

N/A 

N/A 

N/A 

0. 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

N/A 

11T259 

99 .7 

970  79  . 

0. 

*7n»9. 

**718, 

0. 

o. 

*9687. 

*9687. 

C. 

0. 

*9687 

i*  : 

2 

131*25. 

171017. 

99  .2 

9  30  39  . 

0- 

9307*. 

75954. 

0. 

0. 

609*6. 

6?  98  6 . 

0. 

0. 

6r  9*6 

is: 

3 

1 3  3?  9* 

99 .7 

9  TO  39. 

L. 
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UNCLASSIFIED***EX4MPLE  OF  THE  OUTPUT  FROM  UTILITY  CEM/LOSSES* ••UNCLASS  IF  IE  0 
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8.70 

.42 

.21 

19 : 

.00 
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12. 

0  23.0 

33.0  27.0  27.0 
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Figure  III.  18.7 


unclassifieo««»exampl£  of  the  output  oat*  froh  utility  control/compiler. ..unclas 

1 ITEHPORARY  CONTROL  DATA  FILE  W  ARF  P83C120EC 
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.0  2 

.00 

if  : 

.15 

.15 

.  10 

.10 

.05 

.05 

.OS 

17: 

A8  .1 

51.5 

52  .0 
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1.25* 

927 

.  A9  A 

.000 

.633 
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57.00 

60. no 

8.70 

.00 
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Figure  III.  18.8 
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CHAPTER  19 


UTILITY  -  FINAL/REPORT 

19.1  DESCRIPTION  -  The  purpose  of  this  utility  is  to  combine  the  three  out¬ 
put  files  from  the  ELCON  program  and  the  ITMID/FINAL  file  to 
produce  a  report  on  WARF  daily  attrition  rates.  Since  the  output  from 
ELCON  expresses  loss  rates  in  monthly  terms,  this  utility  will  divide  the 
ELCON  loss  rates  by  30  to  determine  the  daily  rates.  The  only  output 
from  this  utility  is  the  printed  report.  The  report  is  not  used  as  input  to 
any  following  automated  program,  but  may  be  used  in  the  final  printed 
study  report. 

19.2  STRUCTURE  -  Figure  III.  19.1  displays  the  overall  structure  of  this 
utility. 

19.3  DATA  BASE  -  The  data  base  which  is  used  to  support  this  utility 
consists  of  four  files.  One  file,  the  ITMID/FINAL,  is  produced  by  the 
ITMID/REC-A  utility.  The  remaining  3  files,  RATES-XX/SEQ-1, 
RATES-XX/MONTHLY-WOL,  and  RATES-XX/MONTHLY-WL  are 
produced  by  ELCON.  All  files  are  stored  on  mass  storage  devices  under 
the  program  file  of  the  current  study,  in  this  case 
SECRET*82WARFP88. 

19.4  RUNSTREAM  -  The  runstream  used  to  control  the  execution  of  this 
utility  is  pictured  in  Figure  III.  19.2.  The  runstream  is  cataloged  as  an 
element  under  the  program  file  CSTART*82XQT.  As  the  runstream 
executes,  it  accomplishes  the  following  functions: 

o  Assigns  to  the  logical  unit  88  the  current  study's  program  file,  in 
this  case  SECRET*82WARFP88,  and  requires  the  user  to  supply  the 
appropriate  password. 

o  Assigns  to  the  logical  unit  8,  file  RATES-XX/SEC-1;  unit  9, 
RATES-XX/MONTHLY-WL;  unit  10,  ITMID/FINAL;  and  unit  11, 
RATES-XX/MONTHLY-WOL. 

o  Executes  the  utility. 

o  The  results  of  the  utility  are  collected  on  unit  7  and  copied  into  the 
permanent  file  FINAL/REPORT-XX.  The  XX  portion  of  the  file 
name  must  be  changed  to  reflect  the  current  CEM  Run  Control 
Number  which  can  be  obtained  from  the  CEM  Operator/ Analyst. 

o  The  existing  82PRT  file  is  deleted. 

o  The  82PRT  file  is  created  again  and  unconditionally  cataloged  as  a 
public  file  with  no  read/write  key. 

o  Using  the  Breakpoint  facility  of  the  UNIVAC  1100,  prepare  the 
FINAL/REPORT  file  for  printing  and  assign  it  a  header  "record." 
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o  Schedule  the  report  for  printing  on  unlined  paper, 
o  Deletes  the  print  file  82  PRT  after  printing, 
o  Releases  the  resources  allocated  to  the  utility. 


INPUT  -  The  utility  uses  four  input  files,  all  cataloged  under  the  current 
study's  program  file,  in  this  instance,  SECRET*82WARFP88.  These 
files  are  the  ITMID/FINAL,  RATES-XX/SEC-1,  RATES-XX/MONTHLY- 
WOL  and  RATES-XX/MONTHLY-WL.  Each  file  is  discussed  below. 

o  ITMID/FINAL  -  This  file  is  produced  by  the  ITMID-REC-A  utility. 
It  details  each  major  item  of  equipment  being  analyzed  in  the 
study.  For  each  item  it  provides  the  item's  code  identifier, 
nomenclature  or  description,  its  CEM  type  artillery 

vulnerability/historical  class  (where  applicable)  as  well  as  a  period 
by  period  summary  of  the  authorized  quantities  of  this  item  plus  a 
combat  zone  by  combat  zone  summary  of  the  distribution  or 
density  of  the  item  throughout  the  battle  area.  Figure  III.  19.3 
presents  the  example  of  the  data  for  this  file. 

FILE:  ITMID/FINAL 

STORAGE  MEDIUM:  Mass  Storage 

SOURCE:  UTILITY  -  ITMID/RECA 


RECORD  FORMAT: 


Position 

Description 

Format 

Record  1: 

1 

Blank 

IX 

2  -  7 

Line  item  number  (LIN) 

A6 

8 

Blank 

IX 

9  -  38 

Alphanumeric  nomenclature 

5(A6) 

39 

Blank 

IX 

40  -  41 

Type  equipment  code  for  losses 
from  theater  model 

12 

42  -  43 

Vulnerability  class  for  losses 
from  artillery  model 

12 

44  -  45 

Classification  for  historical  data 

12 

46  -  48 

In-theater  depot  stockage  (number 
of  days  supply) 

13 

49  -  50 

Fraction  of  intertheater  shipment 
which  is  by  air 

F2.2 

51  -  52 

=  1  if  actual  equipment  density  is 
to  be  read  and  used 

12 

V  '  . 


=  0  if  density  is  to  be  estimated 
from  the  number  of  divisions  in 
theater 

53-54  =  1  if  combat  losses  are  from  the  12 

theater  simulation 

=  2  if  combat  losses  are  from  artil¬ 
lery  models 

=  3  if  all  loss  are  from  history 

55  -  58  Sequence  number  14 


Position  Description 


Format 


Record  2: 


1  -  49  Quantities  of  this  line  item  for  7(17) 

the  seven  time  periods  of  the 
exercise,  obtained  from  the  new 
ITMID/TEWP  file. 


Record  3-9: 


1  -  35  Density  Profiles  for  Time  Period  5(F5.2) 

N  for  this  line  item  in  each  of 
the  five  zones  or  areas  being 
played  in  this  exercise.  These 
density  profiles  are  obtained  from 

the  new  ITMID/TEMP  file.  There  must  j 

be  seven  occurrences  of  this  record; 

one  for  each  time  period  being  ' 

played.  j 

o  RATES-XX/SEC-1  -  This  file  is  produced  by  the  ELCON  program.  f 

It  summarizes  for  the  utility  the  control  information  under  which  1 

the  ELCON  program  was  executed.  In  addition  to  a  summary  for 
each  major  piece  of  equipment  a  summary  of  its  loss  rates  in  dif¬ 
ferent  periods  from  a  variety  of  causes.  The  USACAA  document 
CAA-D-79-3  in  Appendix  B  presents  a  complete  example  of  a  typi¬ 
cal  file  on  pages  Dl  -  D2.  The  FINAL/REPORT  program  will 
simply  read  this  file  and  write  the  contents  out. 

It  should  be  noted  that  the  ELCON  program  discussed  in  Chapter  2 
has  the  option  of  executing  without  producing  this  file.  If  this  is 
the  case,  the  FINAL/REPORT  program  will  not  execute  because  it 
expects  the  file  to  exist. 
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o  RATES-XX/MONTHLY-WOL  -  This  file  details  for  each  major  item 
of  equipment  in  the  study  in-theater  monthly  losses  per  WARF  set 
excluding  LOC  and  Depot  losses.  Figure  III.  19.4  presents  the 
sample  data  for  this  file. 

FILE;  RATES-XX/MONTHLY-WOL 
STORAGE:  Mass  Storage 
SOURCE;  ELCON 


RECORD  FORMAT; 

Column  Description  Format 

1  BLANK  TX 

2  -  7  LINCODE  A6 

8  BLANK  IX 

9-38  Nomenclature  5(A6) 

39  -  86  Monthly  loss  rates  of  this  item  8(F6.2) 

for  each  time  period  in  the 
study.  These  rates  are  calcu¬ 


lated  excluding  LOC  and  Depot 
losses. 

o  RATES-XX/MONTHLY-WL  -  This  file  details  for  each  major  item 
in  the  study  total  monthly  loss  rates  per  WARF  set  including  LOC, 
depot  and  inter-theater  shipping  losses.  Figure  HI.  19.5  presents  the 
sample  data  for  this  file. 

FILE:  RATES-XX/MONTHLY-WL 

STORAGE:  Mass  Storage 

SOURCE;  ELCON 

RECORD  FORMAT; 

Column  Description  Format 

1  BLANK  IX 

2-7  LINCODE  A6 

8  BLANK  X 

9-38  Nomenclature  5(A6) 

39  -  86  Monthly  loss  rates  of  this  item  81F6.2) 

for  each  time  period  in  the 
study.  These  loss  rates  are 
calculated  using  LOC,  Depot  and 
inter-theater  shipping  losses. 

OUTPUT  -  The  only  output  from  this  utility  is  the  FINAL/REPORT. 

This  report  is  a  formatted,  primed  summary  of  daily  loss  rates  of  the 

Materiel  Postprocessor  (MPP)  and  the  ELCON. 


It  should  be  emphasized  that  loss  rates  expressed  in  this  report  are  daily 
loss  rates  rather  than  monthly  loss  calculated  in  the  ELCON.  To  get 
these  daily  loss  rates  the  monthly  loss  rates  are  simply  divided  by  30. 

Figure  III.  19.6  presents  an  example  of  the  FINAL/REPORT  output. 

PERFORMANCE  -  This  utility  will  require  the  following  resources  in 
order  to  execute  properly; 

CORE;  Less  than  30K 

CPU  TIME:  Less  than  3  minutes 

CLOCK  TIME:  Less  than  10  minutes 

DISK  UNITS:  Four  (file)  units,  default  (128  tracks)  storage 

COMMENTS:  None 
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Figure  III.  19. 1 


UNCLASSIEIED.t.EILE  NAME  1 C  ST  AR T *  92  XGT  ELEMENT  N  AHE  1FINAL/REP0RT  •  •  »UNCL  ASS  IEIE  D 


3 

4 
r 

f 

7 

6 

a 

in 

ii 

1? 

13 

14 

IE 

If 

17 

IE 

15 
30 
21 


?f 

37 
29 

29 

30 

n 

3? 

33 

24 

25 
3f 
17 

38 

39 

40 

41 

42 

43 

44 
4' 
4f 
47 
4E 


S  US  E  88  •  »  SE  CRET  .82RCK87  • 
SASG.A  88/  / 

SASG.T  7  •  •  /  //  500 
SASG.T  8  •  *  /  //  200 
SASG.T  9..///200 

10..  ///500 

11 ..  // /200 
92XG  T. 

.RATES-40/SFC-I.  8. 


8  AS  G.  T 
SASG.T 
S  AS  G.  A 
SEO  38 
EXIT 
SEO 
EXI  T 
SEO 
EXIT 
SEO 
EXIT 
SMS  S.N 
SMSG.N 
SMSG.N 
SMSG.N 
SMS  G.  N 


88  .RAT  ES- 40 /MO  NT  HI  Y-WCL.  11. 


38  .RAT  ES- 40 /MO  NT  HE  Y-WL  .9  . 


38.ITMIO/EINAL,10. 


the  eour  element  files  above  contain  the  in°ut  data 
eor  THIS  utility,  the  first  three  contain  the  output 

OF  THE  EICON  ANO  THE  FOURTH  THE  FINAL  TTMID  FILE. 

THE  ITMTP  FILE  IS  USED  HERE  THE  RETRIEVE  the  AUTHORIZED 


the  a3ove  element  file  *fimal/report-40*  will  contain 

THE  OUTPUT  OF  THIS  UTILITY.  THE  FINAL  WARF  ATTRITION 
RATES  REFCRT  FOR  A  SFECIFIC  COM  RUN.  THE  *XX*  IN  THE 
ELEMENT  NAME  must  correspond  the  cem  run  CONTROL  number. 


QUANTITIES  of  each  lin  code  »mie>. 

3X0T  82X0T.EINAI/REP0RT 
SED  7.  *88.  FINAL/ RE  PORT— 40 
115 
P  20 
LAST 
EXIT 
SMSG.N 
SMS  G.  N 
SMS  3.  N 
SMSG.N 
SCELETE.C  82PRT. 

SASG.UP  82PRT  ..///500 
SRRKPT  PRINT3/32PRT 

S  HO  G  ESI  ATTRITION  RATES  WITH  3  WITHOUT  LOG  LOSSES  WARF  87 

SPRT.S  88. E  INAL/REr0RT-40 
S9RKPT  PRINT* 

SEP  EE  82PRT. 

SSYM  82  PR  T  •  .  .  PR2 

SMSG.N  THE  A30VE  BRKPT  WILL  FROVIOE 
SMSG.N  ON  UNLINED  PAPER. 

SOELETF.C  3  2PRT. 

SEP  EE  7. 

SEE  EE  8. 

SFREE  9. 

SFREE  10. 

SFREE  11. 

SFREE  88. 


A  PRINTED  COPY  OF  THE  REPORT 


Figure  HI. 19.2 
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AY"* 


UNCLASSIFIED***!  XA  MPLE  or  TH£  OUTPUT  OF  UTILITY  ITMIO/RE C- A* • *UNCL ASSI FIFO 


l : 

A0  319S  »K 

VEH  M218  GM  EG  P1A 

U  522 

30  0 

21 

54 

64 

44 

58 

78 

88 

38 

3 : 

.00  .00 

.  00 

•  80 

.20 

4 : 

.00  .00 

.00 

•  80 

.  20 

5 : 

.00  .00 

.00 

•  80 

.  20 

6 : 

.00  .00 

.00 

.80 

.20 

?: 

.00  .00 

.00 

.80 

.20 

a: 

.00  .00 

.00 

•  SO 

.20 

9 : 

.00  .00 

.00 

.78 

.25 

10 : 

A14752  ADAP  TEST 

CAMERA  LM178 

01636 

30  0 

u: 

10 

16 

16 

17 

17 

17 

17 

i?: 

.00  .00 

.20 

.80 

.00 

13: 

.00  .00 

.20 

.80 

.00 

14: 

.00  .00 

.20 

.80 

.00 

is: 

.00  .00 

.  15 

.85 

.00 

16 : 

.00  .00 

.  15 

.85 

.00 

it: 

.00  .00 

.  35 

.65 

.00 

is : 

.00  .00 

.  35 

.65 

.00 

19! 

A2249E  AIMING  CIRCLE 

M2  W/E 

01636 

30  0 

20 : 

6615  6699 

3820 

8823 

8823 

8823  8978 

21 : 

.25  .25 

.50 

.00 

.00 

22 : 

.25  .25 

.  50 

.00 

.00 

23: 

.25  .25 

.  SO 

.00 

.00 

24: 

.25  .25 

.50 

.QU 

.00 

25 : 

.25  .25 

.  50 

.00 

.00 

26: 

.25  .25 

.  50 

.DU 

.00 

27 : 

.25  .25 

.  SO 

.00 

.00 

28 : 

A2  3770  AIR 

C  CNC 

FL/WNDV  60000 

01B33 

30  0 

29: 

0 

0 

0 

0 

0 

0 

0 

30 : 

.00  .00 

.00 

.00 

.00 

31 : 

.00  .00 

.00 

.00 

.00 

3?: 

.00  .00 

.00 

.ou 

.00 

33: 

.00  .00 

.00 

.00 

.00 

34 : 

.00  .00 

.00 

.00 

.00 

35: 

.00  .00 

.00 

.00 

.00 

36 : 

.00  .00 

.00 

.00 

.00 

37: 

A2  3828  AIR 

CONO 

F/WA 

9000  BTU 

01833 

30  0 

33 : 

889 

99  3 

9  98 

998 

998 

998 

998 

39 : 

.00  .00 

.25 

.25 

.SO 

40 : 

.00  .00 

.  25 

.2  5 

.50 

4i : 

.00  .00 

.25 

.25 

.50 

42 : 

.00  .00 

.  25 

.25 

.50 

43: 

.00  .00 

.  25 

.25 

.  50 

44 : 

■  00  .00 

.  25 

.25 

.  50 

45 : 

.00  .00 

.  25 

.25 

.50 

46  : 

A24044  Arp 

CONO 

18000 

BTU 

01833 

30  0 

47: 

S3 

5  3 

53 

55 

55 

55 

55 

48 : 

.00  .00 

.00 

.50 

.50 

49 : 

.00  .00 

.00 

.50 

.50 

50: 

.00  .00 

.00 

.50 

.50 

5i : 

.00  .00 

.00 

.50 

.50 

52: 

.00  .00 

.00 

.30 

.70 

53: 

.00  .00 

.00 

.30 

.70 

54 : 

.00  .00 

.00 

.30 

.70 

55: 

A24318  AIR 

CONO 

18000 

BTU 

01833 

30  0 

56: 

15 

25 

42 

57 

63 

83 

97 

57: 

.00  .00 

.  25 

.75 

.00 

I 


2 


3 


4 


5 


6 


7 


Figure  III.  19.3 
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UNCL ASSIflfD •• *E XA MPLC  OF  RA  TE  S-^X /MON  THLY-WOL  OUTPUT  DATA  FROM  UTILITY  TLCON/J 


i  : 

AO  .11  98 

AK  VC  M  M2 18  CM  Ffl  P 14 

2-43 

3.21 

2.85 

2-48 

3.14 

3.11 

2 

.28 

3 

.03 

2.85 

2 

.80 

2  2 
32 

A1  «7  52 

AOAP  TEST  CAMERA  LM170 

0.04 

10.65 

9.64 

9.79 

10.49 

10.  ?6 

8 

.08 

7 

.06 

10.  oc 

8 

.4  7 

4  2 
r.  i 

l  2 
7  2 

*2  ?4  36 

AIMIN'*.  CIRCLE  M2  W/E 

30.73 

40.37 

35.58 

39.79 

49.34 

46.76 

?1 

.56 

18 

•  44 

42.10 

28 

.86 

A2  3770 

AIR  CCNO  FL/WNOU  6000  P 

.00 

.00 

.00 

.00 

.00 

•  00 

•  00 

•  00 

.00 

.0  0 

0  2 
q  : 

102 
u  : 

A2  38  28 

AIR  CONO  F/WA  9000  8T U 

1.15 

1.77 

1.49 

1.44 

2.14 

2.10 

.95 

.87 

1.69 

1 

.3  1 

A2  4044 

AIR  CCNO  1800U  8TU 

•  60 

.74 

.67 

.47 

•  83 

.74 

•  33 

.47 

•  66 

.51 

l? : 


Figure  III.  19.4 


uvCL4ss:rrco...t)t««PLr  or  thf  A.rts-xx, 

-  h  ONTMl  f-ML 

o  j  fPOT 

DATA 

FROM 

ELC  ON/3 

l : 
? : 

*0  3138 

AH 

VEM  M2 18  GM  EO  P1A 

2.83 

8.52 

5.34 

3.27 

11.82 

6.57 

3.15 

3.31 

7.18 

4.2  1 

3: 
4 : 

A1 4752 

AOAP  TF57  CAMERA  LH 17  8 

G.70 

24.23 

18.63 

13.13 

17.44 

12.51 

9.14 

7.84 

16.54 

3.77 

5 : 
g  : 

A2  24  36 

ATMING  CIRCLE  M2  M/C 

37.08 

43.58 

43.34 

57.60 

73.84 

56.98 

24.38 

20.51 

59.07 

33.28 

7 : 
s : 

A2 3770 

AIR 

COND  FL/WNOW  6000  0 

.00 

.00 

.00 

•  00 

•  00 

•  00 

.00 

.00 

.CO 

.no 

4 : 
10  ! 

A2  38  28 

AIR 

CONO  F/MA  3000  BT  U 

1.36 

5.25 

3.41 

1.38 

3.13 

2.49 

1.06 

.94 

2.83 

l  .47 

ii : 

i  7  : 

A2  40  44 

AIR 

COND  18000  BTU 

.71 

.87 

.73 

.82 

2.31 

.88 

.37 

.50 

1.21 

.5  8 

Figure  III.  19.5 
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) 


t 


i 


i 


UNCL  ASSIFIC0*4«EXAMPLE  of  THF  OUTPUT  FROM  UTILITY  FINAl/REPORT***UNCLASSIF IEO 

is  0*  IlY  ATTRITION  RATES 

? : 

T:  TEMPORARY  CONTROL  OATA  F IL  €  WARF  P88I12DEC 
4  : 


* : 
t  : 


a : 

NP£R  MX  IT  H  » 

CEM  CUSSES  AMARF  SETS 

9  ; 

7  6 

9  10 

io  : 

n : 

12! 

DAYS  PER  P  ER 100 

13: 

15  15  30 

30  30  3  0  30 

iu: 

is: 

16 : 

FIRST  ANO  LAST 

PERIOD  FOR  EACH  WAR F  SET 

17 : 

1  1 

1? : 

2  2 

• 

n : 

1  2 

20 : 

3  3 

*. 

2i : 

4  4 

22 : 

5  5 

23: 

6  6 

24 : 

7  7 

25 : 

1  4 

G 

?6 : 

5  7 

; 

27: 

f 

?s : 

' 

29: 

AIR  LOSS  RATE 

BY  P  ER  100 

30 : 

.050  .050 

.050  .010  .010  *000  .000 

u : 

3? : 

33 : 

SE  A  LOSS  R  ATE 

8V  PERIOD 

74 : 

.150  .150 

.2  30  .100  .050  .020  .000 

is: 

3£ : 

it  : 

LOC  LOSS  RATE 

BY  PERIOD 

* 

1 

39 : 

.150  .150 

.100  .100  .050  .050  .050 

t 

39 : 

1 

40 : 

i 

< 

41 : 

average  large 

UNITS  BY  PERIOD 

i 

4?: 

4  8.10  51  .50 

52.00  52.00  52.00  52.00  52.00 

4  3 : 

» 

44 : 

i 

45 : 

r»»cTioN  or  roRCF  nr  rcSTURf  by  pfrioO 

i 

4E : 

attack  offend 

WITHDRAW  INACTIVE 

i 

47 : 

.0000  .1410 

.0590  .8000 

* 

us : 

.75  50  .1  450 

.0500  .eooo 

49: 

.2000  .1550 

.0050  .6400 

50 : 

.  1000  .0550 

•1050  .8400 

si : 

.00  50  .0550 

•1400  .6000 

5? : 

.  3050  .0050 

.0000  .6900 

53 : 

•  55  50  .0000 

•0000  .4450 

54 : 

55 : 

5t : 

ARTY  KILLS  It 

PER  DA Y 1  BY  VU  LN  CLASS  BY  POSTURE 

57  t 


Figure  IH.19.6 


229 


r 

'  « 


r+jr^ 


UWCl  ASSI/IfO*.*!  «AWPl£  0P  THf  OUTPUT  r»0M  u 


TL  ITT  rTNAl/»f  P0RT***U*ClASSH 


s* : 

.000 

.  SS* 

.211 

1.999 

.27? 

.111 

.999 

•  090 

.138 

•  999 

.97* 

5*: 

.72* 

.691 

.29* 

.  71* 

.SSS 

.7** 

•  399 

.907 

•  9** 

.921 

.100 

6o: 
ti : 

.  100 

.SS? 

.too 

7.  7** 

.570 

.000 

.799 

.000 

.70* 

.000 

2.192 

t?: 

7.907 

3.  13S 

.990 

1.  7  SO 

J  .1  SS 

.so? 

.070 

.919 

.991 

.000 

.000 

ts: 

t* : 

.200 

2.  SOT 

1.25* 

.  S27 

.*s* 

.000 

.933 

.000 

.283 

.28* 

1.909 

si : 

S.7S  J 

j.  m 

.  RSS 

3.  001 

2  .970 

1.7BS 

.*95 

.898 

.999 

.000 

•  090 

ct : 
t* : 

•  OS  0 

.  25  S 

.  09  * 

.  555 

.BIB 

.010 

.089 

.990 

.823 

.790 

.098 

t« : 

3.1*2 

7.  U0 

•  S3  3 

.  050 

.973 

.3*9 

.077 

.090 

.778 

•  000 

.080 

89: 

to: 
t  i : 

t? :  ARTT  SCALNQ  factors  by  PERlOO 

Ti:  .1*1  .Ti*  • 440  1.000  .ISO  .*IS  .lit 


t*  : 
?s  : 
ti  : 
?? : 
to  : 
to  : 
io : 
•i: 
•?: 
as: 
ho  : 
as : 
*6 : 
®7 : 

as: 
as: 
u: 
oi : 

17 : 

oj: 


CE*  KILLS  (t  P  F  R  SO  OATS)  «Y  CL  *  SS  OT  PERIOD 


6  « . 000  l.AOO 
a  s.  ooo  t.Moo 
SO. 000  .900 

7T.000  .500 

IT.  000  .*00 

30.000  .300 

17.000  .100 


.000  .000  10.000  2*. 000  38.000  77.000 
.000  7. 000  TO. 000  3*. 000  57.000  SO. 000 
.000  7.000  IS. 000  7*. 000  37.000  2R.OOO 
.000  .000  S.OOO  IS. 000  7S.OOO  10.000 
.000  .000  9.000  13.000  IS. 000  *.000 
.000  *.000  *.000  1* .000  33.000  3.000 
.000  2.000  1.000  7.000  IS. 000  1.000 


7.  SOO 
*.200 
2.300 
.SOO 
.500 
.100 
.100 


is : 
st : 
s?: 
is  : 
is: 

100: 

101: 
loz : 
ioj: 
ia*; 
ios: 
ios: 
lor: 
lot: 
ios: 
no: 
m: 
u?: 
ns: 

It*:  DAILY  ATTRITION  RATES  WITHOUT  ANO  WITH  LOB  LOSStS 


1  is: 

i  it: 
iit: 
n»: 
us: 

1 70 : 
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